gift-cards.write
scope.Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
The ID of the merchant account to use for this request.
"default"
Body
The 16-19 digit number for the gift card.
16 - 19
"4123455541234561234"
The PIN for this gift card.
1
"1234"
The ID of the buyer to associate this gift card to. If this field is provided then the buyer_external_identifier
field needs to be unset.
"fe26475d-ec3e-4884-9553-f7356683f7f9"
The external_identifier
of the buyer to associate this gift card to. If this field is provided then the buyer_id
field needs to be unset.
1 - 200
"buyer-12345"
Response
Successful Response
The ID for the gift card.
"356d56e5-fe16-42ae-97ee-8d55d846ae2e"
The ID of the merchant account this buyer belongs to.
"default"
The service this gift card belongs to.
The first 6 digits of the full gift card number.
"412345"
The 3 digits after the bin
of the full gift card number.
"554"
The last 4 digits for the gift card.
"1234"
The date this gift card record was created at.
"2013-07-16T19:23:00.000+00:00"
The date this gift card record was last updated at.
"2013-07-16T19:23:00.000+00:00"
Always gift-card
.
"gift-card"
"gift-card"
The date and time when this gift card expires. This is a full date/time and may be more accurate than the actual expiry date received by the gift card service.
"2013-07-16T19:23:00.000+00:00"
The buyer for which this gift card is stored.