3.1 推送交易 (银行、钱包)(payoutQueue)
这个API是由SkyPay提供,并由Partner进行主动推送。 当客户取得支付交易核准信息,Partner必须透过此界面推送支付数据进行支付交易。 
Input parameters:
| 参数 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| userName | string | 50 | 是 | 使用者名称 由SkyPay提供 Ex:"userName":"AppName@skypay" |
| action | string | 50 | 是 | 调用行为 payoutQueue(固定参数值) Ex:"action":"payoutQueue" |
| authentication | string | 50 | 是 | 验证密钥 Ex:"authentication":"E1234567-123C-1234-123F-A12345670" |
| sender | string | 100 | 是 | 支付方 产品APP名称(由合作伙伴设计) Ex:"sender":"APP NAME" |
| controlNumber | string | 13~15 | 是 | 取款码 前缀码5码+8~10个数字（前缀码在绑定邮箱中获取） Ex:SKY**12345678 |
| name | string | 50 | 是 | 取现人名字 必须使用逗号分割: "Last name（必填）,First name（必填）,Middle name,Suffix" Ex:"name":"Lardizabal,Mary Annalou B.Lardizabal,Berja, |
| phone | string | 11 | 是 | 手机号 08/09开头的11位数字 Ex:"phone":"09270348095" |
| amount | string | 10.2 | 是 | 金额 支付金额支持数字小数位两位 Ex:"amount":3400.00 |
| bankNo | string | 50 | 是 | 银行代码 银行渠道进行支付时必填，电子钱包无此参数；请参考第十章章接口10.6 Get Bank Code,银行代码为3位的字符 |
| accountNo | string | 50 | 是 | 账户号 电子钱包：账号为取现人08/09开头11位长度之手机号码 Bank:取现人指定银行账号 |
| withdrawChannel | int | 5 | 是 | 指定支付渠道代码 参考第十二章管道详细说明渠道code值 |
| identificationId | string | 50 | 否 | 身份证件号码 依不同身份验证方式,持有证件编号 Ex:"identificationId":"442301922000" |
| identificationTypeId | string | 3 | 否 | 验证身份证件类别 参考10.3 Get Identification Type 银行渠道进行支付时选填，电子钱包无此参数 Ex:":identificationTypeId":"2" |
| idType | string | 50 | 否 | 验证身份证件类别 电子钱包进行支付时选填，银行无此参数 Ex:"idType":"TIN" |
| idcardPicType | string | 50 | 否 | 图片格式 电子钱包进行支付时选填，银行无此参数Ex:"idcardPicType":"jpg" |
| idcardPicUrl | string | 500 | 否 | 相片存取网络地址 电子钱包进行支付时选填，银行无此参数Ex:"idcardPicUrl":"" |
| birthday | Date | 10 | 否 | 生日格式 yyyy-MM-dd Ex:"birthday":"1991-10-02" 写入此字段，参数需要填入正确格式 |
| birthPlace | string | 250 | 否 | 出生地 银行渠道进行支付时选填，电子钱包无此参数 |
| location | string | 500 | 否 | 取款人地址 Ex:"location":manila" |
| provinceId | int | 5 | 否 | 省份ID 请参考第十章接口10.5 Get Province 银行渠道进行支付时选填，电子钱包无此参数 Ex:ProvinceId 1 Abra - 2 Agusan del Norte… |
| cityId | int | 5 | 否 | 城巿ID 请参考第十章接口10.4 Get Town City 银行渠道进行支付时选填，电子钱包无此参数 Ex:省份Id城巿Id城巿名称 - 47 996 Manila… |
Post data
支付为电子钱包时,调用API送出的数据格式内容:
{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
}
支付为银行时,调用API送出的数据格式内容:
{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
}
Output parameters:
| 参数 | 类型 | 长度 | 描述 |
|---|---|---|---|
| responseTime | DateTime | 50 | 回传时间 yyyy-MM-dd HH:mm:ss.SSSS |
| responseCode | int | 4 | 回传代码 1000 |
| responseDescription | string | 255 | 回传内容描述 Success |
Output data：
{
: ,: ,
:
}
Return code:
| 状态代码 | 状态描述 |
|---|---|
| 1000 | Success |
| -1000 | Post context is not valid |
| -1001 | Invalid Accountnumber |
| -1008 | Control number is already exists |
| -1009 | Unpredictable exception occur/Merchant is not available |
| -1016 | Insufficient balance |
| -1020 | Bank city is incorrect |
| -1021 | Bank No is incorrect |
| -1022 | Invalid Accountnumber |
| -1027 | balance limit exceeded |
| -1028 | Has exceeded the limit of 10 transactions per day |
| -1032 | Your IP xxx is not whitelisted.Please contact Support Team. |
| -9999 | Service not available/Connection error |