Yuansfer API 文档
搜索文档…
注解

交易对象

参数
类型
说明
transactionNo
string
Yuansfer系统中的交易ID。
reference
string
商家系统中交易的发票编号。
originalTransactionNo
string
Yuansfer系统中原始交易的ID。
merchantNo
string
商家ID
storeNo
string
商店ID
storeAdminNo
string
商店管理员ID
amount
number
交易金额(美元)。
refundAmount
number
退款金额。
voidAmount
number
无效或取消的金额。
transactionType
string
交易类型。
可能的值为:“付款”,“退款”,“无效”。
transactionStatus
string
交易状态
currency
string
标识货币的三个字符货币代码。 可能的值为:“ USD” “ CNY” “ PHP”
“ IDR” “ KRW” “ HKD”。
createTime
string
The date and time when the authorization was created.
Format : "yyyy-MM-dd HH:mm:ss".
paymentTime
string
创建授权的日期和时间。
格式:“ yyyy-MM-dd HH:mm:ss”。
exchangeRate
number
美元和人民币之间的汇率。
vendor
string
付款方式。
可能的值为:“ alipay”,“ wechatpay”。

响应返回代码

Yuansfer API在ret_code参数中返回以下代码:
返回代码
意义
000000
系统错误
000010
API版本错误
000020
参数为空错误
000021
参数编号无相关信息
000022
参数不匹配
000023
参数值错误
000030
没有权限/访问被拒绝
000040
交易状态错误
000080
供应商系统错误
000100
成功

交易状态

状态
意义
init
创建了新交易,但未发送到付款渠道。
dealing
处理付款。
success
交易已成功处理。
failed
交易失败。
pending
等待付款确认。
closed
设置了付款渠道,但是客户没有继续完成付款操作,所以在一段时间后自动关闭。

付款交易状态

状态
说明
success
资金已计入收款人的帐户
pending
您的付款要求已收到并将被处理
failed
该付款请求失败,因此未从发送者的帐户中扣除资金
returned
收款人尚未领取此款项,因此资金已退还到您的帐户中
refunded
该付款请求已退还
reversed
该付款请求已撤消
unclaimed
此付款的接收者没有PayPal帐户。已把注册PayPal帐户的链接发送给收件人
onhold
此付款请求正在审核中,已暂停
blocked
此付款请求已被阻止

即时付款通知

商家在其网站上创建IPN侦听器页面,然后在请求正文中指定侦听器页面的URL。然后Yuansfer API将会把所有与交易相关的事件的通知发送到该URL。当客户为商品或者服务付款时,API会将包含付款信息(IPN消息)的安全的表单POST发送到URL。 IPN侦听器使用商家进程检测并处理IPN消息。 IPN侦听器页面包含一个自定义脚本或程序,该脚本或程序等待后端消息,验证成功状态然后将它们传递给各种后端应用程序进行处理。 IPN侦听器必须向Yuansfer响应“success”字符串(不带引号),否则Yuansfer将发送异步付款通知8次。 IPN与您网站上的操作不同步。 网络连接并不总是完全可靠,因此IPN消息可能会丢失或延迟。 IPN服务会自动重新发送消息,直到侦听器确认为止。该服务在2小时内最多可重新发送消息8次。

回调参数

自动付款交易通知

自动付款后会发送成功通知。 此异步回调通知将包含诸如autoDebitNo,autoReference,customerBelognsTo,time,note和verifySign的参数。
参数
类型
说明
autoDebitNo
string
Yuansfer系统中自动扣款的唯一ID。
autoReference
string
商户系统中自动扣款的唯一ID。
vendor
string
付款渠道,可能的值为“ gcash”,“ kakaopay”,“ alipay”,“ alipay_hk”,“ dana”,“ truemoney”,“ tng”,“ easypaisa”,“ bkash”。
time
string
创建授权的日期和时间
格式:“ YYYYMMDDHHMMSS”。
note
string
付款注释。

付款交易通知

当商家的系统收到Yuansfer系统的回调时,建议商家的系统通过使用verifySign验证回调信息中的参数,以确保数据未被篡改。
Yuansfer在回调(包括IPN)中将返回以下参数。
参数
类型
说明
transactionNo
string
Yuansfer系统中的交易ID。
status
string
交易状态
amount
string
交易金额(美元)。
currency
string
USD,CNY,PHP,IDR,KRW,HKD的交易单位。
这是列出价格的货币。
settleCurrency
string
这是将向商家付款的货币。
time
string
创建授权的日期和时间
格式:“ YYYYMMDDHHMMSS”。
reference
string
商家系统中交易的发票编号。
vendorId
string
供应商交易ID
note
string
付款注释。
verifySign
string
参数签名。

Yuansfer时区

Yuansfer的工作时区为UTC +8。
最近更新 9mo ago