注解
参数 | 类型 | 说明 |
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的工作时区为UTC +8。
最近更新 2yr ago