Create Crypto Refund

Designing

POST

/v1.0/payment/crypto/createCryptoRefund

When an incoming crypto payment is flagged as high-risk by our KYT scoring engine, the payment will be placed in a pending-refund state. A webhook containing the KYT result will be sent to the client.

To initiate a refund for this payment, the client must call this endpoint and provide the original transaction type and transaction ID.

If a pending refund exists for the specified payment, a Refund ID will be created and returned.

If no pending refund is available, an error will be returned.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "originalTransactionType": 1,
    "originalTransactionId": "string",
    "clientReference": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1.0/payment/crypto/createCryptoRefund' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "originalTransactionType": 1,
    "originalTransactionId": "string",
    "clientReference": "string"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "string",
    "msg": "string",
    "data": {
        "cryptoRefundId": "string",
        "originalTransactionType": 1,
        "originalTransactionId": "string",
        "participantCode": "string",
        "clientReference": "string",
        "status": 1,
        "blockchain": "string",
        "currency": "string",
        "amount": "string",
        "feeCurrency": "string",
        "feeAmount": "string",
        "txnHash": "string"
    }
}

Modified at 2026-01-20 07:34:16

Update Co-KYT status

Confirm Crypto Refund