1. Payment
OPEN-API
  • API Call Description
  • Constant Declaration
    • Wallet
      • Wallet Status
      • In Out Type
      • Transaction Type
      • Transaction Status
    • Bin
      • Bin Type
      • Bin Mode
      • Bin Status
    • Card
      • Card Status
      • Card Trade
        • Card Trade Type
        • Card Trade Result
    • Order
      • Card Type
      • Order Type
      • Order Status
      • Order Bill
        • Order Bill Type
        • In Out Type
        • Bill Category
    • Payee
      • Payee Status
    • Payment
      • Fee Mode
      • Payment Status
  • Webhook
    • Card Notify
      • Order
      • Card
      • Card Trade
    • Payee Notify
    • Payment Notify
    • Wallet Notify
  • Api
    • Wallet
      • 钱包列表
      • 钱包详情
      • 交易流水列表
      • 交易详情
      • 获取兑换汇率
    • Card
      • Bin
        • 卡Bin列表
        • 卡Bin详情
        • 卡Bin费用
        • 卡Bin限制
      • Card
        • 卡列表
        • 卡详情
        • 卡激活
        • 卡冻结
        • 卡解冻
        • 发起销卡
        • 卡交易列表
        • 商户交易评分
      • Order
        • 开卡
        • 卡充值
        • 订单列表
        • 订单详情
      • Holder
        • 持卡人列表
        • 创建持卡人
        • 编辑持卡人
        • 持卡人详情
        • 删除持卡人
    • PayMethod
      • 付款方式
    • Payee
      • 运营资金来源列表
      • 预期付款目的列表
      • 创建收款方
      • 编辑收款方
      • 申请收款方
      • 删除收款方
      • 收款方列表
      • 收款方详情
    • Payment
      • 付款原因
        POST
      • 创建付款
        POST
      • 付款列表
        POST
      • 付款详情
        POST
  1. Payment

付款详情

POST
/{{version}}/openApi/payment/getPayment

使用场景#

 付款详情。
请求参数#
Http Post Application/json
字段类型是否必传描述
customer_idlong是客户id
app_idlong是应用id
keystring是授权key
payment_idstring是付款id
示例
{
    "customer_id": 10001001,
    "app_id": 100005,
    "key": "cce57ad3869b4f95804f267fadda99ac",
    "payment_id": "pm_ihcfKtnKg50aTZ5D"
}
响应内容#
字段类型是否必传描述
payment_idstring是付款id
payee_idstring是收款方id
wallet_snstring是扣款钱包sn
pay_out_amountfloat是付款金额
pay_out_currencystring是付款币种
rate_idstring是汇率id
exchange_ratefloat是汇率
entry_amountfloat是入账金额
entry_currencystring是入账币种
entry_countrystring是入账国家/地区
feefloat是付款手续费
fee_detailobject是付款手续费明细
fee_detail.fix_feefloat是付款固定手续费
fee_detail.fix_fee_currencystring是付款固定手续费币种
fee_detail.same_name_feefloat是付款同名手续费
fee_detail.same_name_fee_currencystring是付款同名手续费币种
fee_detail.rate_feefloat是付款比例手续费
fee_detail.rate_fee_currencystring是付款比例手续费币种
fee_detail.total_feefloat是付款总手续费(根据付款钱包币种计算)
fee_detail.exchange_rate_idstring是付款手续费汇率id,同币种为空,如果不同币种为汇率id
fee_detail.exchange_ratefloat是付款手续费汇率id,同币种为"1",如果不同币种为汇率
fee_detail.pay_methodstring是付款方式
fee_detail.fee_modestring是手续费承担模式
fee_detail.fee_ratefloat是手续费率
fee_detail.our_feefloat是全额承担费用
fee_detail.sha_feefloat是部分承担费用
pay_methodstring是付款方式
fee_modestring是付款手续费模式
is_same_nameint是是否同名转账 1:是; 0:否
payment_datestring是入账日期
payment_reasonstring是付款原因
payment_postscriptstring是交易附言
remarkstring是备注
statusint是状态
create_atdatetime是创建时间
approve_atdatetime是审批时间
complete_atdatetime是完成时间
refund_atdatetime是退款时间
示例
使用场景


Plain Text








 B端用户,付款详情。


请求参数
Http Post Application/json
字段类型是否必传描述token





string





是





token令牌





app_id





long





是





应用id





payment_id





string





是





付款id






示例


JSON








{
    "token": "pXAVLTey5oD-1GudxTglCShHCy8dTKMP4ykkdQou7kwsjdtqxSAQRf9lnuUwnki9PPVPZDoZUonRYJX0Qv-9SPq22IvN-gGWnCEAKJCD0sTvdymXlMc1XluivuX6RvnB9QAFJfEeCx1yX7iO0ttXZMo5lS1yXf8NnWdMKwSNiKjgo47GAkEraDXfMKY3T2_8i11wUdDrLiXSJhCMVsBNqEvsada0RWc8WucVyOeZmkTqc9Ya3dM6__sXAAD__w==",
    "app_id": 100006,
    "payment_id": "pm_ihcfKtnKg50aTZ5D"
}


响应内容
字段类型是否必传描述payment_id





string





是





付款id





payee_id





string





是





收款方id





wallet_sn





string





是





扣款钱包sn





pay_out_amount





float





是





付款金额





pay_out_currency





string





是





付款币种





rate_id





string





是





汇率id





exchange_rate





float





是





汇率





entry_amount





float





是





入账金额





entry_currency





string





是





入账币种





entry_country





string





是





入账国家/地区





fee





float





是





付款手续费





fee_detail





object





是





付款手续费明细





fee_detail.fix_fee





float





是





付款固定手续费





fee_detail.fix_fee_currency





string





是





付款固定手续费币种





fee_detail.same_name_fee





float





是





付款同名手续费





fee_detail.same_name_fee_currency





string





是





付款同名手续费币种





fee_detail.rate_fee





float





是





付款比例手续费





fee_detail.rate_fee_currency





string





是





付款比例手续费币种





fee_detail.total_fee





float





是





付款总手续费(根据付款钱包币种计算)





fee_detail.exchange_rate_id





string





是





付款手续费汇率id,同币种为空,如果不同币种为汇率id





fee_detail.exchange_rate





float





是





付款手续费汇率id,同币种为"1",如果不同币种为汇率





fee_detail.pay_method





string





是





付款方式





fee_detail.fee_mode





string





是





手续费承担模式





fee_detail.fee_rate





float





是





手续费率





fee_detail.our_fee





float





是





全额承担费用





fee_detail.sha_fee





float





是





部分承担费用





pay_method





string





是





付款方式





fee_mode





string





是





付款手续费模式





is_same_name





int





是





是否同名转账 1:是; 0:否





payment_date





string





是





入账日期





payment_reason





string





是





付款原因





payment_postscript





string





是





交易附言





remark





string





是





备注





status





int





是





状态  
1:待审批  
2:处理中  
3:已驳回  
4:已完成  
5.付款失败  
6.已退款





create_at





datetime





是





创建时间





approve_at





datetime





是





审批时间





complete_at





datetime





是





完成时间





refund_at





datetime





是





退款时间






示例


JSON








{
    "code": 0,
    "message": "success",
    "data": {
        "payment_id": "pm_k3AxCFA9cJpgy4K1",
        "payee_id": "pe_WRTf8QiSTj6iWMDR",
        "wallet_sn": "d81e2aab59964da79fe76eaf253a2106",
        "pay_out_amount": 123,
        "pay_out_currency": "HKD",
        "rate_id": "ex_FZTmCerZ1uDvmiSr",
        "exchange_rate": 0.129948,
        "entry_amount": 15.98,
        "entry_currency": "USD",
        "entry_country": "US",
        "fee": 234.63,
        "fee_detail": {
            "fix_fee": 20,
            "fix_fee_currency": "USD",
            "same_name_fee": 10,
            "same_name_fee_currency": "USD",
            "rate_fee": 0.07,
            "rate_fee_currency": "HKD",
            "total_fee": 234.63,
            "exchange_rate_id": "ex_DY0pkYSwzNaByEJg",
            "exchange_rate": 7.8186,
            "pay_method": "SWIFT",
            "fee_mode": "OUR",
            "fee_rate": 0.0005,
            "our_fee": 20,
            "sha_fee": 0
        },
        "pay_method": "SWIFT",
        "fee_mode": "OUR",
        "is_same_name": 1,
        "payment_date": "2025-07-23",
        "payment_reason": "广告费",
        "payment_postscript": "广告费",
        "remark": "转账付款",
        "status": 1,
        "create_at": "2025-07-16 08:03:18",
        "approve_at": "",
        "complete_at": "",
        "refund_at": ""
    }
}

请求参数

Body 参数application/json

示例
{
	"customer_id": 10001004,
	"app_id": 100006,
	"key": "0408ab79eb214e7d81d9fd447b5916a2",
    "payment_id": "pm_bf7FeKd7t63czyrj"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://prod-cn.your-api-server.com/{{version}}/openApi/payment/getPayment' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customer_id": 10001004,
	"app_id": 100006,
	"key": "0408ab79eb214e7d81d9fd447b5916a2",
    "payment_id": "pm_bf7FeKd7t63czyrj"
}'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2026-03-19 06:16:48
上一页
付款列表
Built with