Create a gift card token

A gift card is a prepaid payment card used to make purchases at participating restaurants, stores, or online retailers. A gift card can have different denominations. You can redeem the value of these cards for services, merchandise, or even cash, depending on the terms and conditions set by the card issuer.

Prerequisites

To process secure gift card payments, you need one of the following:

• Native gift card with a SCV (security code value). Clover Gift Card uses the integrated gift card solution payment gateway from Fiserv.
• Non-native gift card with an FCA (foreign access code). This is a non-Fiserv gift card or a gift card that does not use the Fiserv payment gateway.

Steps

1. Generate a PAKMS key.
2. Send a POST request to the /v1/tokens endpoint. See Create a gift card token.
3. Enter information in the required fields.

A single-use gift card token is returned in the response. The token is alphanumeric and begins with clv_. Example: clv_1TSTSECWntExtCdPXnbFjkgN

4. Use the gift card token for a single transaction to:
   • Create a charge
   • Pay for an order
   • Request gift card balance
   • Reload gift card
   • Request cashout of gift card balance
   • Create and activate physical and virtual gift card

Request example

curl --request POST \
     --url 'https://token-sandbox.dev.clover.com/v1/tokens' \
     --header 'apikey: xxx' 
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "gift_card": {
    "card_number": "98765441066",
    "security_code": "785577",
    "foreign_access_code": "67755"
  }
}'

Response example

{  
    "id": "clv_1TSTSECWntExtCdPXnbFjkgN",  
    "object": "token",  
    "giftCard": {  
        "last4": "1066"  
    }  
}