Public
Documentation Settings

GiftKarte Online Redemption Test APIs

Welcome to GiftKarte API for Online Redemption of our E-Gift Cards.

Our API allows you to integrate your website to our platform, giving customers the ability to redeem our E-Gift Cards to use our website for payment.

We use a RESTful endpoint with an API Key which is used to authorize the API. Responses are returned as JSON.

Note: Each vendor will receive a specific Access Key from GiftKarte.

POSTE-Gift Card Validation

https://www.giftkarte.com/vendor/api/validate

The E-Gift Card Validation API allows you to get E-Gift Card detail.

  • If the entered E-Gift Card is correct & valid format, then you'll receive a successful response.
  • If the entered E-Gift Card is incorrect/invalid format then you'll receive a unsuccessful response.

Response Status & Messages

True - E-Gift Card successfully applied

False - You have entered an invalid E-Gift Card details

Bodyformdata
access_key

{{access_key}}

Unique Vendor Access Key

e_giftcard

{{e_giftcard}}

E-Gift Card Format: GK-Gift Card Number-Security Code

cart_amount

{{cart_amount}}

Customer Cart Amount

Example Request
curl
curl --location 'https://www.giftkarte.com/vendor/api/validate' \
--form 'access_key="c4cf65386dabab4847cb2a0ff5133f87"' \
--form 'e_giftcard="GK-12345678ABCD-1234"' \
--form 'cart_amount="500"'
Example Response
Text
{
  "status": true,
  "e_giftcard_amount": 500,
  "message": "E-Gift Card successfully applied"
}
No response headers
This request doesn't return any response headers

POSTE-Gift Card Redeem

https://www.giftkarte.com/vendor/api/redeem

The E-Gift Card Redemption API allows you to redeem Gift Card.

  • If the entered E-Gift Card, receiver's phone number is correct & valid format, then you'll receive a successful response.
  • If the entered E-Gift Card, receiver's phone number is incorrect & invalid, then you'll receive a unsuccessful response.

Response Status & Messages

True - E-Gift Card successfully redeem

False - You have entered an invalid E-Gift Card details

Bodyformdata
access_key

{{access_key}}

Unique Vendor Access Key

e_giftcard

{{e_giftcard}}

E-Gift Card Format: GK-Gift Card Number-Security Code

cart_amount

{{cart_amount}}

Customer Cart Amount

order_number

{{order_number}}

Customer Order Number

Example Request
curl
curl --location 'https://www.giftkarte.com/vendor/api/redeem' \
--form 'access_key="c4cf65386dabab4847cb2a0ff5133f87"' \
--form 'e_giftcard="GK-12345678ABCD-1234"' \
--form 'cart_amount="500"' \
--form 'order_number="1234ABCD"'
Example Response
Text
{
  "status": true,
  "txn": "ABCD1234",
  "e_giftcard_amount": 500,
  "redeemed_amount": 500,
  "message": "E-Gift Card successfully redeemed"
}
No response headers
This request doesn't return any response headers