Refund Decision Callback

Version: 3.0.0

Method

POST

Url

https://{YOUR_SERVICE_URL}/(refund_decision: 22)

This API endpoint is for receiving the refund decision. When the originator VASP submits the refund decision (Refund API 4) via GTR, you as the beneficiary VASP will receive this callback with the decision result. If the decision is accept, you should proceed the on-chain refund transfer and notify the refund tx via Refund API 2. If the decision is reject, the reject reason will be included. It is also used to notify the originator VASP when the refund request is cancelled (Refund API 3), with decision = CANCEL and the cancel reason.

Authentication

No authentication

Path Parameters

No path parameters

Query Parameters

No query parameters

Request Body (Required)

Schema

[+]refundBasicInfo

RequiredObject

[+]refundDecision

RequiredObject

Example

{
  "refundBasicInfo": {
    "refundId": "testexchange-189e9948-64c7-4a6c-bb4f-859c173321c5"
  },
  "refundDecision": {
    "refundRejectReason": {
      "rejectReason": "Originator VASP does not currently support refunds for the requested asset/network combination",
      "rejectReasonType": "OTHER"
    },
    "decision": "ACCEPT",
    "refundCancelReason": {
      "cancelReasonType": "SYSTEM_ERROR",
      "cancelReason": "Originator VASP-side decision timeout"
    }
  }
}

Responses

Status HTTP Status: 200, VerifyStatus: 100000

default response

JSON Content

Schema

[+]data

OptionalObject

verifyMessage

OptionalString

verifyStatus

OptionalInteger (int32)

Example

{
  "verifyStatus": 100000,
  "verifyMessage": "Verify Success"
}