On This Page

Credit with a Token

This section describes how to process a stand-alone credit.
WARNING
Follow these guidelines to prevent unauthorized credits.
A
stand-alone credit
 is a credit that is not linked to a capture. There is no time limit for requesting a stand-alone credit.
When a request for a credit is successful, the issuing bank for the payment card takes money out of your merchant bank account and returns it to the customer. It usually takes two to four days for your acquiring bank to transfer funds from your merchant bank account.
Carefully control access to the credit service. Do not request this service directly from your customer interface. Instead, incorporate this service as part of your customer service process.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/credits/
Test:
POST
https://apitest.cybersource.com
/pts/v2/credits/

REST Example: Credit with a Token

Request
{
    "clientReferenceInformation": {
        "code": "1234567hgh8"
    },
    "paymentInformation": {
        "instrumentIdentifier": {
            "id": "D6B858CAD38A1B7CE0531D588D0ADB5D"
        },
        "card": {
            "expirationMonth": "03",
            "expirationYear": "2031",
            "type": "062"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "225.00",
            "currency": "THB"
        }
    }
}
Response to a Successful Request
{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/credits/6538345097226017503265/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/credits/6538345097226017503265"
        }
    },
    "clientReferenceInformation": {
        "code": "1234567hgh8"
    },
    "creditAmountDetails": {
        "currency": "TBH",
        "creditAmount": "225.00"
    },
    "id": "6538345097226017503265",
    "orderInformation": {
        "amountDetails": {
            "currency": "TBH"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "062"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "062"
        },
        "instrumentIdentifier": {
            "id": "D6B858CAD38A1B7CE0531D588D0ADB5D",
            "state": "ACTIVE"
        },
        "card": {
            "type": "062"
        }
    },
    "reconciliationId": "6538345097226017503265",
    "status": "PENDING",
    "submitTimeUtc": "2024-04-25T12:06:44Z"
}