Save Card

The Save Card endpoint is used to tokenize a customer’s card after completing a successful order. Once saved, the response includes a cardToken that can be used for future payments via the Tokenized Charge API.

💡

Good to know

• You must complete the order successfully before using this endpoint.
• Payload should be encrypted using RSA encryption (PKCS#1 v1.5).
• This helps securely store the customer’s card for seamless future payments.

Headers

Header	Value	Description
api-key	{{your_secret_key}}	Your TransactPay secret key

Payload Structure (before encryption)

Key	Type	Description	Required
reference	string	The unique reference of the completed order	✅

---

Encrypted Payload (what you send)

JSON

{
  "data": "{{encrypteddata}}"
}

---

Sample Payload (before encryption)

JSON

{
  "reference": "ORDER123456"
}

---

Sample Success Response

JSON

{
    "data": "{{Card Token}}",
    "status": "success",
    "statusCode": "00",
    "message": "Card saved successfully"
}

JSON

{
    "data": "{{encrypteddata}}"
}