1. 支付网关
TrustPay
zh
  • en
  • zh
  • 接入说明
  • 签名计算
  • 支付风控接口 - 商户接入指南
  • 支付网关
    • 枚举类型说明
    • 支付回调说明
    • C21 支持区域
      • TrustPay API 与 Checkout 支持的国家和 US/CA 州省
    • 白名单管理
      • 添加卡白名单
      • 导入任务查询
      • 查询卡白名单
    • 卡直付
      POST
    • 收银台
      POST
    • 订单退款
      POST
    • 支付回调通知
      POST
    • 订单查询
      POST
    • 余额查询
      POST
    • 费率查询
      POST
    • 退款查询
      POST
  • 争议管理
    • 争议枚举
    • 争议预警
    • 争议预警回调
    • 争议预防(RDR)
    • 争议管理(Chargeback)
    • Chargeback 回调
  • 信用卡开卡
    • 查询可用卡类型
      POST
    • 开通虚拟卡
      POST
    • 开卡/充值回调通知
      POST
    • 获取虚拟卡详情
      POST
    • 虚拟卡充值
      POST
    • 订单列表查询
      POST
    • 虚拟卡列表查询
      POST
    • 卡片列表
      POST
    • 流水查询
      POST
    • 费率查询
      POST
  • 实体卡
    • 创建持卡人
    • 持卡人列表
    • 绑定持卡人
    • 持卡人绑定列表
    • 查询实体卡余额
    • 查询交易记录
    • 查询账户
    • 实体卡充值
  • Payment Gateway
  • Schemas
    • VCardDetail
    • VOrderDetail
  1. 支付网关

枚举类型说明

以下常量来自当前 TrustPay API 和回调实现。不同接口只支持其中一部分值,请以具体接口文档为准。

支付订单类型#

值常量说明
0payin代收 / 入账支付
1payout代付 / 出账支付

回调通知类型#

回调 JSON 字段名为 type。
值常量说明
0payin代收回调
1payout代付回调
2refund退款回调
3exchange承兑回调
4chargeback拒付/争议回调
5vcard虚拟卡回调
6pcard实体卡回调

订单状态#

值常量说明
1pending待支付
2paid已支付,通常表示代付成功
3failed处理失败
4timeout处理超时
5unliquidated代收成功,等待结算
6statement结算单已确认
7refunded已全额退款
8partially_refunded已部分退款
9refunding退款中
10audit_pending承兑订单待审核
11audit_approved承兑订单审核通过
12audit_rejected承兑订单审核拒绝
13exchange_completed承兑订单已完成
14exchange_cancelled承兑订单已取消
17settled已结算
19reversed上游已全额撤销,独立于退款和拒付
值 15 未定义。
正式争议和争议预警枚举已迁移至 争议管理 / 争议枚举。

代收支持币种#

值说明API 版本
USD美元v4
INR印度卢比v4

代付支持币种#

值说明API 版本
INR印度卢比v2

错误码#

错误码常量
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 04:30:27
Previous
支付风控接口 - 商户接入指南
Next
支付回调说明
Built with