version | string | Yes | 接口版本 当前值为:1.5 |
keyVersion | string | Yes | 密钥版本 当前值为:1 |
requestTime | string | Yes | 请求时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 |
appId | string | Yes | 商户应用Id,PayerMax分配给商户应用的唯一标识 |
merchantNo | string | No | 商户号,商户与PayerMax业务签约时生成的唯一标识 |
data | object | Yes | 请求数据体 |
data.country | string | Yes | 国家代码,大写字母,参见【支持的国家与币种】 |
data.chargeOption | string | No | 费用承担模式,是否必传参照《付款申请模板及填写规范》 |
data.clearingRail | string | No | 枚举值为:SWIFT, SEPA, LOCAL,分别对应签约的SWIFT、SEPA、Local Banks支付方式,请根据实际要用的支付方式来上送,请参照《付款申请模板及填写规范》 |
data.sourceAccount | string | No | 扣款账户的币种代码,大写字母 |
data.destinationCurrency | string | No | 到账币种,请参考【支付方式列表】,如有标明到账币种的,需要指定到账币种;若未标明,则到账币种仅支持本币,不需要进行指定 |
data.payeeInfo | object | Yes | 收款方信息 |
data.payeeInfo.paymentMethodType | string | Yes | 支付方式,参见【支付方式类型及目标机构说明】 |
data.payeeInfo.targetOrg | string | No | 目标机构,参见【支付方式类型及目标机构说明】 |
data.payeeInfo.payeeType | string | No | 收款方类型(PERSONAL/CORPORATION),默认PERSONAL |
data.payeeInfo.accountInfo | object | No | 收款账户信息 |
data.payeeInfo.accountInfo.accountNo | string | No | 收款方账号,根据付款方式不同填入相应账号 |
data.payeeInfo.accountInfo.accountType | string | No | 收款账户类型,在不同国家-支付方式下规范不同 |
data.payeeInfo.accountInfo.checkDigit | string | No | 收款方账户验证数字 |
data.payeeInfo.bankInfo | object | No | 收款方银行信息 |
data.payeeInfo.bankInfo.bankCode | string | No | 用于识别特定金融机构下的收款方银行代码,在不同国家下填写规范不同,参见【付款申请模板及填写规范】以及【支持银行范围列表】 |
data.payeeInfo.bankInfo.bankName | string | No | 收款方银行名称 |
data.payeeInfo.bankInfo.bankBranch | string | No | 收款人银行网点号/分行号 |
data.payeeInfo.bankInfo.bankCity | string | No | 收款方银行所在城市 |
data.payeeInfo.bankInfo.corAccountNo | string | No | 收款方银行的代理账号(correspondent account) |
data.payeeInfo.name | object | No | 收款方姓名,支持英文、空格、逗号、中划线、点,在不同国家-支付方式下填写规范不同 |
data.payeeInfo.name.firstName | string | No | 收款方名 |
data.payeeInfo.name.middleName | string | No | 收款方中间名,多段中间名时,使用空格进行分隔 |
data.payeeInfo.name.lastName | string | No | 收款方姓 |
data.payeeInfo.name.fullName | string | No | 收款方全名 |
data.payeeInfo.document | object | No | 收款方个人身份信息 |
data.payeeInfo.document.documentType | string | No | 收款方个人身份证明类型,在不同国家下可选类型不同,参见《付款申请模板及填写规范》 |
data.payeeInfo.document.documentId | string | No | 收款方个人识别号码,在不同国家下可选类型不同,参见《付款申请模板及填写规范》 |
data.payeeInfo.document.documentIssueDate | string | No | 收款方个人识别号码生效日期,在不同国家下可选类型不同,yyyy-MM-dd格式 |
data.payeeInfo.document.documentExpireDate | string | No | 收款方个人识别号码失效日期,在不同国家下可选类型不同,yyyy-MM-dd格式 |
data.payeeInfo.address | object | No | 收款方地址信息 |
data.payeeInfo.address.address | string | No | 收款方地址 |
data.payeeInfo.address.city | string | No | 收款方城市 |
data.payeeInfo.address.state | string | No | 州 |
data.payeeInfo.address.zipCode | string | No | 收款方邮编 |
data.payeeInfo.payeePhone | string | No | 收款方移动电话号码,在不同国家-支付方式下填写规范不同 |
data.payeeInfo.birthDate | string | No | 收款方出生日期,yyyy-MM-dd格式 |
data.payeeInfo.email | string | No | 收款方邮箱 |
data.payeeInfo.payeeNationality | string | No | 收款人国籍,ISO 3166-1 alpha-2标准,如CN,US |
data.payeeInfo.payeeGender | string | No | 收款人性别,枚举值F 或M(F=Female,M=Male) |
data.payeeInfo.payeeBirthCountry | string | No | 收款人出生国家,ISO 3166-1 alpha-2标准,如CN,US |
data.payerInfo | object | No | 付款方信息 |
data.payerInfo.name | object | No | 付款方姓名,支持英文、空格、逗号、中划线、点,在不同国家-支付方式下填写规范不同 |
data.payerInfo.name.firstName | string | No | 付款方名 |
data.payerInfo.name.middleName | string | No | 付款方中间名,多段中间名时,使用空格进行分隔 |
data.payerInfo.name.lastName | string | No | 付款方姓 |
data.payerInfo.name.fullName | string | No | 付款方全名 |
data.expiryDays | string | No | 取款码有效天数,当前仅在FawryCash中有效,支持传入1~15整数(1=24Hours),其他值或不传则默认为7 |
data.remark | string | No | 出款附言或备注,允许英文,数字,中划线,空格,点;受渠道约束,该字段可能会进行特殊处理,如超长截断或填充默认值 |
data.notifyEmail | string | No | 收款方通知邮箱,目前只有个别支付方式会发送取款码邮件,比如FAWRY |
data.notifyPhone | string | No | 收款方通知电话 |
data.purpose | string | No | 出款目的,枚举值,ISUBIL:向公用事业提供商付款(i.e.水电煤账单); EPTOUR:旅游业; EPTKAG:支付旅游门票或旅行社费用; ISPAYR:支付工资; ISPAYRA:支付代理工资; ISGDDS:货物买卖; ISSCVE:购买和销售服务; ISSUPP:供应商付款; ISLOGS:物流和运输服务付款; INCEN:激励/促销/用户获取活动; GAME:游戏设备、游戏币和其他游戏物品; SAMENM:企业同名账户转账; PAYCMSN:报销/福利发放/佣金发放; SAMENMC:法人/股东/董事个人账户; AGOPEXP:代运营费用结算; ADEXP:广告费用结算;RFND:退货;SMCNTST:子商户结算;LGTEP:供应商付款-物流费用结算;GOODPAY:供应商付款-货款结算;SINVEST:股票投资;FINVEST:基金投资;TAXPAY:纳税/支付税款;LOANPAY:支付贷款; OTHER:其他; |