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)


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

Sample Payload (before encryption)


{
  "reference": "ORDER123456"
}

Sample Success Response

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

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