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

Enums

The values below are defined by the current TrustPay API and callback implementation. An endpoint may support only a subset; follow the endpoint-specific documentation.

Payment Order Type#

ValueConstantDescription
0payinCollection / incoming payment
1payoutDisbursement / outgoing payment

Callback Notification Type#

The callback JSON field is type.
ValueConstantDescription
0payinPayin callback
1payoutPayout callback
2refundRefund callback
3exchangeExchange callback
4chargebackChargeback callback
5vcardVirtual card callback
6pcardPhysical card callback

Order Status#

ValueConstantDescription
1pendingPending payment
2paidPaid; typically payout succeeded
3failedProcessing failed
4timeoutProcessing timed out
5unliquidatedPayin succeeded and is awaiting settlement
6statementSettlement statement confirmed
7refundedFully refunded
8partially_refundedPartially refunded
9refundingRefund in progress
10audit_pendingExchange order awaiting review
11audit_approvedExchange order approved
12audit_rejectedExchange order rejected
13exchange_completedExchange order completed
14exchange_cancelledExchange order cancelled
17settledSettled
18accounting_holdAccounting review because upstream amount evidence is missing or inconsistent
19reversedFully reversed by the upstream provider; distinct from refund and chargeback
Value 15 is not defined.
Formal dispute and Dispute Alert enums are documented in Dispute Management / Dispute Enums.

Payin Supported Currency#

ValueDescriptionAPI Version
USDUnited States Dollarv4
INRIndian Rupeev4

Payout Supported Currency#

ValueDescriptionAPI Version
INRIndian Rupeev2

Error Codes#

CodeConstant
880001success
880002bad_request
880003database_error
880004remote_error
880005insufficient_balance
880006invalid_transaction_type
880007inner_error
880008order_failed
880009freeze_payout_amount_failed
880010backend_success
880011unauthorized
880012order_already_exists
880013internal_error
880014all_channel_failed
880015break_amount_rule
880016channel_config_error
880017user_risk_control_failed
880018card_failure_limit_exceeded
880019account_limit_exceeded
880020daily_amount_limit_exceeded
880021daily_count_limit_exceeded
880022quota_limit_exceeded
880023channel_quota_limit_exceeded
880024no_channel_available
880025merchant_fee_config_missing
880026channel_fee_config_missing
880027checkout_session_invalid
880028checkout_session_expired
880029checkout_order_timed_out
880030checkout_session_blocked
880031checkout_order_completed
880032checkout_temporary_unavailable
880033checkout_redirect_invalid
880034checkout_attempt_stale
880035channel_not_supported
880036merchant_checkout_payment_methods_missing
880037merchant_payin_mode_not_allowed
Modified at 2026-08-29 06:36:22
Previous
Risk Control – Merchant Integration
Next
Payment Callback Specification
Built with