Refund Inquiry API

Endpoint
POST {BASE_URL}/api/v2.0/payments/inquiryRefund

The Refund Inquiry API is used to query refund order details based on the AlphaPay refund ID.

Request Body
refundIdstringREQUIRED

AlphaPay refund ID

refundRequestIdstring

Merchant refund ID

Refund Inquiry Request Body
{
    "refundId": "string",
    "refundRequestId": "string"
}
Response (200 OK)
paymentIdstring

AlphaPay order ID

refundRequestIdstring

Merchant refund ID

refundIdstring

AlphaPay refund ID

refundTimestring <date-time>

Refund Time
Follow the ISO8601 standard, e.g. 2019-05-28T12:12:12+08:00

refundStatusstring

Refund order status, please refer to refundStatus

  • REFUND_IN_PROCESS: The refund is being processed
  • SUCCESS: Refund submission succeeded AND refund processing succeeded
  • FAILED: Refund submission failed OR refund processing failed
refundobject

Refund Details

Hide child parameters
refund.refundAmountobject

Refund amount

Hide child parameters
refund.refundAmount.valuestring

The value of refund amount. All amount figures are based on the minimum denomination unit of given currency. Take CAD as an example, 100 means 1.00CAD

refund.descriptionstring

Remark of the refund (maximum length 128 characters) <= 128 characters

refund.notifyUrlstring

Refund notification URL, the address to push the refund success notification after the refund is successful, see Notification for details

resultobject

Process result

Hide child parameters
result.resultCodestring

Process result code, please refer to resultCode

result.resultMessagestring

Process result message

result.resultStatusstring

The status of an API call, please refer to resultStatus

  • S: API call succeeded.
  • F: API call failed, the resultMessage field will provide a detailed description of the error, which could be caused by either the merchant or the platform, when an error occurs during API invocation.
  • U: In cases where the handling result is unknown or in an intermediate state. Such as receiving a PAYMENT_IN_PROCESS status after submitting a payment order, the query interface can be used to confirm the status of the payment result.
Refund Inquiry Response
{
    "paymentId": "string",
    "refundRequestId": "string",
    "refundId": "string",
    "refundTime": "2019-08-24T14:15:22Z",
    "refundStatus": "REFUND_IN_PROCESS",
    "refund": {
        "refundAmount": {
            "value": "string",
            "currency": "CAD"
        },
        "description": "string",
        "notifyUrl": "string"
    },
    "result": {
        "resultCode": "string",
        "resultMessage": "string",
        "resultStatus": "S"
    }
}