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

Payment Callback

POST
{{notify_url}}
This callback is sent to the merchant notify_url. It covers payment and payout lifecycle events and chargeback alert events (type = 7, event_type = chargeback_alert.created). Verify sign before processing, handle chargeback alerts idempotently by alert_id, and return HTTP 200 only after durable acceptance. See Payment Callback Specification, Chargeback Alert Callback, and Signature Calculation.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff '{{notify_url}}' \
--header 'Content-Type: application/json' \
--data '{
    "type": 0,
    "merchant_id": 1,
    "order_no": "payout0003",
    "order_amount": 106,
    "paid_amount": 106,
    "balance_amount": 100,
    "fee": 6,
    "pay_time": "2025-08-05 16:43:55",
    "status": 5,
    "reason": "success",
    "sign": "f561287c9cf9a5af17a97c826af44f6e"
}'
Response Response Example
{}
Modified at 2026-07-27 18:02:52
Previous
Order Refund
Next
Balance
Built with