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

HeaderValueDescription
api-key{{your_secret_key}}Your TransactPay secret key

Payload Structure (before encryption)

KeyTypeDescriptionRequired
referencestringThe unique reference of the completed order✅

Encrypted Payload (what you send)


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

Sample Payload (before encryption)


{
  "reference": "ORDER123456"
}

Sample Success Response

{
  "status": "Successful",
  "statusCode": "00",
  "message": "Successful",
  "data": {
    "isFinalStatus": true,
    "requeryNeeded": false,
    "requeryType": null,
    "orderSummary": {
      "id": 26,
      "paymentReference": "IDSPAY-76279490-6B08-45CF-9919-582E9C77F52B",
      "orderReference": "754874724",
      "totalChargedAmount": 114,
      "fee": 14,
      "statusId": 5,
      "status": "Successful",
      "paymentType": "C",
      "currencyId": 1,
      "paymentResponseCode": "00",
      "paymentResponseMessage": "Successful",
      "providerResponseDate": null,
      "datePaymentConfirmed": null,
      "dateCreated": "2024-03-31T14:05:46.37",
      "narration": "Pay",
      "remarks": "Order initiated and created successfully"
    },
    "orderPayments": [
      {
        "orderId": 26,
        "orderPaymentReference": "PGW-PAYREF-96C2ABCB218C43329037E47268F74195",
        "paymentOptionId": 2,
        "statusId": 5,
        "orderPaymentResponseCode": "00",
        "orderPaymentResponseMessage": "Successful",
        "orderPaymentInstrument": null,
        "remarks": "Order payment initiated",
        "providerReference": "CPF046D30F-3F82-4A9A-B2AD-AC5AE3480D8F",
        "providerResponseCode": "02",
        "paymentUrl": "https://core-api-service.ideospay.dev/web/card/authorize/CPF046D30F-3F82-4A9A-B2AD-AC5AE3480D8F/initiate",
        "externalReference": "N/A",
        "authOption": null,
        "order": null,
        "id": 18,
        "dateCreated": "2024-03-31T14:08:30.6525848",
        "dateUpdated": "2024-03-31T14:08:51.3048026",
        "dateDeleted": null,
        "createdBy": -1,
        "updatedBy": -1,
        "deletedBy": null
      }
    ]
  }
}

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