1. Payment Gateway
TrustPay
en
  • en
  • zh
  • Integration Guide
  • Signature Calculation
  • Payment Gateway
    • Risk Control – Merchant Integration
    • Enums
    • Payment Callback Specification
    • C21 Suport Regions
      • TrustPay Supported Billing Countries and US/Canada Regions
    • Whitelist Management
      • Add Card Whitelists
      • Query Card Whitelists
      • Query Card Whitelists Task
    • Card Direct Payin
      POST
    • Cashier Payin
      POST
    • Order Refund
      POST
    • Payment Callback
      POST
    • Balance
      POST
    • Order Query
      POST
    • Fee Query
      POST
    • Refund Query
      POST
  • Dispute Management
    • Dispute Enums
    • Dispute Alert
    • Dispute Alert Callback
    • Dispute Prevention (RDR)
    • Dispute Management(Chargeback)
    • Chargeback Callback
  • Credit Card Issuer
    • Available Card
      POST
    • Open Card
      POST
    • Open/Recharge Card Callback
      POST
    • Get Card Detail
      POST
    • Card Recharge
      POST
    • Order List
      POST
    • Card List
      POST
    • Transaction List
      POST
    • Fee Query
      POST
  • Physical Card Issuer
    • Create Cardholder
    • List Cardholders
    • Assign Physical Cards
    • List Assigned Physical Cards
    • Query Card Balance
    • Query Card Transactions
    • Query Account
    • Card Charge
  • Schemas
    • VCardDetail
    • VOrderDetail
  1. Payment Gateway

Refund Query

POST
/v4/query/refund

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.trustpay.money/v4/query/refund' \
--header 'Content-Type: application/json' \
--data '{
    "merchant_refund_no": "MRF-test_orderC16_001-1770739743065",
    "sign": ""
}'
Response Response Example
Refund Status Failed
{
    "code": 880001,
    "message": "success",
    "data": {
        "merchant_refund_no": "admin_direct_dTy5VgH5CfwwjEE5J29WZXDf",
        "platform_refund_no": "dTy5VgH5CfwwjEE5J29WZXDf",
        "order_no": "c24-test-payin-007",
        "refund_amount": 10,
        "currency": "USD",
        "status": 6,
        "refund_status": 3,
        "refund_type": "refund",
        "source": "admin_manual",
        "failed_reason": {
            "current": {
                "error": "880004: Unauthorized"
            },
            "history": [
                {
                    "failed_at": "2026-07-16T07:44:30Z",
                    "reason": {
                        "error": "880004: Unauthorized"
                    },
                    "retry_count": 0
                }
            ]
        },
        "create_time": "2026-07-16T07:44:29.622569Z",
        "finished_time": "2026-07-16T07:44:30.723066Z"
    }
}
Modified at 2026-08-27 07:19:20
Previous
Fee Query
Next
Dispute Enums
Built with