Search
K
Gift Cards

Virtualizes the specified gift card which must be already active.

This registers the information that this gift card is used on an electronic system into the gift card server.
This call fetches the gift card to check if it really is already active, then creates a transaction for the gift card,
and sends a fake activation call to the gift card server. This activation is expected to fail (as the card is already active)
but will be logged on the gift card server side so that people know that this card is associated with a mobile device.

post
https://api-qual.migros.ch/migros/customers/payment-methods/v1/personal-giftcards/{person_id}/cards/{card_id}/virtualize

Query Parameters

pinstringrequired

Gift Card Pin. Required for security reasons, even though not mandatory by gift card SOAP service.

POS_IDstring

Gift Card POS Protocol Specification Version 1.5.0.

<= 16 characters

TERMINAL_IDstring

Gift Card POS Protocol Specification Version 1.5.0.

<= 16 characters

STORE_IDstring

Store Number/Merchant number.

<= 16 characters

SELLER_NAMEstring

The name of the sales person.

<= 16 characters

POS_TIMESTAMPstring(date-time)

Local transaction date from POS.

POS_TRANS_IDstring

Transaction ID from POS.

<= 16 characters

Path Parameters

person_idstringrequired

Customer’s person ID.

card_idstringrequired

Gift Card ID to activate.

Response

Returned when successful

post/migros/customers/payment-methods/v1/personal-giftcards/{person_id}/cards/{card_id}/virtualize
 

Creates a new gift card with the specified profile.

Each user may only have one single electronic gift card. If the user already has a gift card, this call just returns that card, but without the CARD_PIN information.

This call checks if mgo provides a stored digital card for the current user. If so, that card is returned,
otherwise a new card is created with the gift card server, the card id converted to a product id (with the 2of5 checksum)
and stored in mgo for later use. The pin is not stored on any server and thus only sent once for a new card.
There is no recovery process for lost pins because the gift card server does not provide one.
The app has to make sure the user creates backups of the pin for his virtual card.

post
https://api-qual.migros.ch/migros/customers/payment-methods/v1/personal-giftcards/{person_id}/profiles/{profile}

Query Parameters

TERMINAL_IDstring

Gift Card POS Protocol Specification Version 1.5.0.

<= 16 characters

STORE_IDstring

Store Number/Merchant number.

<= 16 characters

SELLER_NAMEstring

The name of the sales person.

<= 32 characters

POS_TIMESTAMPstring(date-time)

Local transaction date from POS.

POS_TRANS_IDstring

Transaction ID from POS.

<= 16 characters

Path Parameters

person_idstringrequired

Customer’s person ID.

profilestringrequired

Profile of the card to create.

Response

Returned when successful

post/migros/customers/payment-methods/v1/personal-giftcards/{person_id}/profiles/{profile}
 

Classification

object

Represents a gift card classification.

category_codestring
labelstring
label_codestringrequired

Position in the category.

position_in_categoryinteger
valuestring

Value of the classification.

value_codestring

Value code of the classification.

Example

GiftCard

object

Represents a gift card in the API.

classificationsarray[object]

Represents a gift card classification.

Show Child Parameters
digitalboolean

Is this a digital gift card or not.

disclaimerstring

Terms and conditions.

hintstring
idstringrequired

ID of the gift card.

imageOne Of
Imageobject

An image and its properties.

Show Child Parameters
namestringrequired
Example

Image

object

An image and its properties.

codestringDEPRECATED

Code for the image, useful for pictograms.

customstringDEPRECATED

Image URL with placeholders for {width} and {height}.

descriptionstringDEPRECATED

Image description, useful for example as alt attribute.

end_datestring(date-time)DEPRECATED

End date of the validity.

hashstringDEPRECATED

Sha1 hash of original image.

originalstringDEPRECATED

Full size image.

sourcestringDEPRECATED

Source where the image comes from originally.

stackstringDEPRECATED

Image URL with a placeholder for a Rokka {stack}.

start_datestring(date-time)DEPRECATED

Start date of the validity.

tagsarray[string]DEPRECATED
Example