Create Crypto Refund

API Overview

Item	Value
API Status	Stable
Current Version	v1.0
Backward Compatibility	No
Applicable Environment	Production

Description
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

Bearer Token

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

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"
    }
}