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

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 '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-07 03:02:23

Update Co-KYT status

Confirm Crypto Refund