创建订单
参数说明
Request
| name | type | required | desc | example |
|---|---|---|---|---|
| param | JSONObject | YES | 参数 | |
| ─epayAccount | string | YES | 商户EPAY账号 | test2020@epay.com |
| ─category | string | YES | 汇款方式:银行BANK,现金CASH | BANK |
| ─notifyUrl | string | NO | 通知URL | http://192.168.2.6:8380/openapi/apiForward/callBack |
| ─merchantOrderNo | string | YES | 商户订单号 | te3ssd7383d334523t128a |
| ─amount | string | NO | 订单金额 | 10 |
| ─settlementCurrency | string | YES | 结算币种 | USD |
| ─receiveAmount | string | NO | 收款金额 | 可为空 |
| ─receiveCurrency | string | YES | 收款币种,见currencyType说明 | CNY |
| ─version | string | YES | 版本号 | V2.0.0 |
| ─transactionType | string | YES | 交易模式(C2C,B2C,B2B,C2B) | C2C |
| ─channelCode | string | NO | 渠道编码 | 51 |
| ─extendFields | JSONObject | NO | 额外字段 | |
| ─senderInfo | JSONObject | NO | 付款人信息:transactionType为C2C,C2B时必填 | |
| ─ ─surName | string | NO | 姓 | wang |
| ─ ─givName | string | NO | 名 | wu |
| ─ ─gender | string | NO | 性别 | (M:男 F:女) |
| string | NO | 邮箱 | 809334399@epay.com | |
| ─ ─country | string | NO | 汇款国家 | HK |
| ─ ─address | string | NO | 地址 | Santa Clara, CA 3050 Bowers Avenue |
| ─ ─city | string | NO | 城市 | Santa Clara |
| ─ ─area | string | NO | 区号 | 86 |
| ─ ─phone | string | NO | 手机号码 | 13378975778 |
| ─ ─nationality | string | NO | 国籍 | RU |
| ─ ─idType | string | NO | 证件类型 | 2(名词解释有映射说明) |
| ─ ─idNumber | string | NO | 证件号码 | 452245645634534523 |
| ─ ─issueDate | string | NO | 证件签发日期 | 1980-01-01 |
| ─ ─expireDate | string | NO | 证件有效日期 | 2050-01-01 |
| ─ ─birthday | string | NO | 生日 | 1970-01-01 |
| ─ ─occupation | string | NO | 职业 | 1(根据接口查询映射) |
| ─ ─sourceOfFund | string | NO | 资金来源 | 1(根据接口查询映射) |
| ─ ─beneficiaryRelationShip | string | NO | 与收款人关系 | 2(根据接口查询映射) |
| ─ ─purposeOfRemittance | string | NO | 付款目的 | 6(名词解释有映射说明) |
| ─ ─accountNo | string | NO | 付款人银行卡号 | 13721473389 |
| ─ ─zipCode | string | NO | 地址邮编 | 58039 |
| ─ ─states | string | NO | 公司所在州 | shanghai |
| ─ ─country | string | NO | 国家 | CN |
| ─ ─userType | string | NO | 用户类型 | (1:个人 2:企业用户) |
| ─ ─phoneCountry | string | NO | 手机号所属国家 | CN |
| ─ ─postalCode | string | NO | 邮编 | 230000 |
| ─ ─middleName | string | NO | 中间名 | Swiffte |
| ─ ─provinceState | string | NO | 省份 | GuangDong |
| ─ ─taxId | string | NO | 税号 | 8902385331225 |
| ─ ─accountCity | string | NO | 账号所属城市 | TW |
| ─ ─accountCountry | string | NO | 账号所属国家 | TW |
| ─ ─userName | string | NO | 用户名 | Anna |
| ─receiverInfo | JSONObject | NO | 收款人信息:transactionType为C2C,B2C时必填 | |
| ─ ─surName | string | NO | 姓 | li |
| ─ ─givName | string | NO | 名 | lei |
| ─ ─middleName | string | NO | 中间名 | Swiffte |
| ─ ─otherName | string | NO | 其他语言名称 | 리 레이 |
| ─ ─address | string | NO | 地址 | shenzhen |
| ─ ─area | string | NO | 手机区号 | 86 |
| ─ ─phone | string | NO | 手机号码 | 13063456236 |
| ─ ─country | string | NO | 收款国家 | CN |
| ─ ─nationality | string | NO | 国籍 | CN |
| ─ ─idType | string | NO | 证件类型 | 1(名词解释有映射说明) |
| ─ ─idNumber | string | NO | 证件号码 | 1234567890 |
| ─ ─locationId | string | NO | 银行网点位置ID | 3922 |
| ─ ─bankId | string | NO | 银行网点编号 | 3922 |
| ─ ─bankName | string | NO | 银行网点名称 | Orange Money Morocco |
| ─ ─bankBranchName | string | NO | 分行名 | Morocco Orange Money Morocco |
| ─ ─bankBranchCode | string | NO | 分行代码BSB/IBAN等 | WEBPAY |
| ─ ─bankBranchId | string | NO | 分行号 | 12345 |
| ─ ─accountNo | string | NO | 银行卡号 | 13721473389 |
| ─ ─occupation | string | NO | 职业 | 1(根据接口查询映射) |
| ─ ─bankMobile | string | NO | 银行预留手机号 | 1343135324111 |
| ─ ─issueDate | string | NO | 证件签发日期 | 1980-01-01 |
| ─ ─expireDate | string | NO | 证件到期日期 | 2050-01-01 |
| ─ ─licIssuAutho | string | NO | 证件发证机关 | |
| ─ ─remark | string | NO | 备注 | |
| ─ ─accountType | string | NO | 账户类型 | CHECKING |
| ─ ─city | string | NO | 城市 | shenzhen |
| ─ ─states | string | NO | 州 | NanShan |
| ─ ─zipCode | string | NO | 邮编 | 340826 |
| ─ ─country | string | NO | 国家 | CN |
| string | NO | 邮箱 | 809334399@epay.com | |
| ─ ─accountNumber | string | NO | 账户编号 | 093149932 |
| ─ ─phoneCountry | string | NO | 手机号所属国家 | US |
| ─ ─accountCity | string | NO | 账号所属城市 | shenzhen |
| ─ ─accountCountry | string | NO | 账号所属国家 | CN |
| ─ ─currency | string | NO | 币种 | USD |
| ─ ─userName | string | NO | 用户名 | Jone |
| ─ ─birthday | string | NO | 出生日期 | 1989-01-09 |
| ─ ─routingCode | string | NO | ||
| ─ ─ifsCode | string | NO | ||
| ─ ─postalCode | string | NO | 邮编 | 340826 |
| ─ ─provinceState | string | NO | 州,省份 | shenzhen |
| ─ ─transitCode | string | NO | ||
| ─ ─sortCode | string | NO | ||
| ─ ─swift | string | NO | ||
| ─ ─wingMoneyNumber | string | NO | 2341213214223 | |
| ─ ─cardNumber | string | NO | 卡编号 | 2312145621 |
| ─ ─nativeFirstName | string | NO | 原姓 | Li |
| ─ ─nativeLastName | string | NO | 原名 | Lei |
| ─ ─remitterType | string | NO | 支付类型 | 1(名词解释有映射说明) |
| ─ ─ibanNo | string | NO | 国际银行帐户号码 | |
| ─ ─accountAddress | string | NO | 账户地址 | |
| ─ ─routingType | string | NO | 路由类型 | |
| ─ senderBusiness | JSONObject | NO | 付款公司信息:transactionType为B2C,B2B时必填 | |
| ─ ─registeredName | string | NO | 公司注册名称 | |
| ─ ─tradingName | string | NO | 公司名称 | gowins |
| ─ ─address | string | NO | 公司地址 | 安山街道 |
| ─ ─zipCode | string | NO | 地址邮编 | 518000 |
| ─ ─city | string | NO | 公司所在城市 | shenzhen |
| ─ ─states | string | NO | 公司所在州省 | NanShan |
| ─ ─country | string | NO | 公司所在国家 | CN |
| ─ ─msisdn | string | NO | 公司联系电话 | 0556-7782190 |
| string | NO | 公司邮箱 | test2020@epay.com | |
| ─ ─registrationNumber | string | NO | 公司注册编码 | 6496213492511241 |
| ─ ─dateOfIncorporation | string | NO | 公司注册日期 | 2010-09-18 |
| ─ ─purposeOfRemittance | string | NO | 汇款目的 | 1(名词解释有映射说明) |
| ──documentReferenceNumber | string | NO | 文件参考编号 | 32151343 |
| ─ ─taxId | string | NO | 税号 | 879413321 |
| ─ ─accountType | string | NO | 账户类型 | CHECKING |
| ─ ─idNumber | string | NO | id编号 | 43123123 |
| ─ ─nationality | string | NO | 国籍 | CN |
| ─ ─sourceOfFund | string | NO | 资金来源 | 1(根据接口查询映射) |
| ─receiverBusiness | JSONObject | NO | 收款公司信息:transactionType为C2B,B2B时必填 (填写规则请参照付款公司信息) | |
| ─ ─registeredName | string | NO | 公司注册名称 | |
| ─ ─tradingName | string | NO | 公司名称 | |
| ─ ─address | string | NO | 公司地址 | |
| ─ ─zipCode | string | NO | 地址邮编 | |
| ─ ─city | string | NO | 公司所在城市 | |
| ─ ─states | string | NO | 公司所在州 | |
| ─ ─country | string | NO | 公司所在国家 | |
| ─ ─msisdn | string | NO | 公司联系电话 | |
| string | NO | 公司邮箱 | ||
| ─ ─registrationNumber | string | NO | 公司注册编码 | |
| ─ ─dateOfIncorporation | string | NO | 公司注册日期 | |
| ─ ─locationId | string | NO | 银行网点位置ID | |
| ─ ─bankId | string | NO | 收款银行编码 | |
| ─ ─bankName | string | NO | 收款银行名称 | |
| ─ ─bankBranchName | string | NO | 分行名称 | |
| ─ ─bankBranchCode | string | NO | 分行编码 | |
| ─ ─bankBranchId | string | NO | 分行号 | |
| ─ ─accountNo | string | NO | 银行账号 | |
| ─ ─taxId | string | NO | 税号 | |
| ─ ─accountType | string | NO | 账户类型 | |
| ─ ─sortCode | string | NO | 来源码 | 2321312 |
| ─ ─cardNumber | string | NO | 卡号 | 09312241 |
| ─ ─bizName | string | NO | 企业名称 | Epay |
| ─ ─remitterType | string | NO | 支付类型 | 1(名词解释有映射说明) |
| ─ ─ibanNo | string | NO | 国际银行帐户号码 | |
| ─ ─userName | string | NO | 账户所属人姓名 | |
| ─ ─accountCountry | string | NO | 账户所属国家 | |
| ─ ─routingType | string | NO | 路由类型 | |
| ─ ─routingCode | string | NO | 汇款路线号码 | |
| ─ ─swiftCode | string | NO | 银行国际编码 | |
| ─ ─accountAddress | string | NO | 账户地址 | |
| ─ ─postalCode | string | NO | 邮编 | |
| sign | string | YES | 签名 |
Response
| name | type | required | desc | example |
|---|---|---|---|---|
| sign | string | YES | 签名 | |
| epayAccount | string | YES | 您的EPAY账号 | test2020@epay.com |
| version | string | YES | 版本号 | V2.0.0 |
| code | integer | YES | 状态码 1:成功 | 1 |
| message | string | YES | 提示 | success |
| data | JSONObject | YES | 数据 | |
| ─category | string | YES | 汇款方式:银行BANK,现金CASH | BANK |
| ─merchantOrderNo | string | YES | 商户订单号 | te3ssd7383d334523t128a |
| ─epayOrderNo | string | YES | Epay订单号 | 211151598521901746507776 |
| ─status | string | YES | 订单状态 | 9 |
| ─amount | string | YES | 付款金额 | 10.0 |
| ─settlementCurrency | string | YES | 结算币种 | USD |
| ─receiveAmount | string | YES | 收款金额 | 70.6 |
| ─receiveCurrency | string | YES | 收款币种 | CNY |
| ─rate | string | YES | 汇率 | 0.141647 |
| ─fee | string | YES | 手续费 | 1.5 |
| ─extendFields | string | YES | 额外字段 | null |
| ─rateMode | string | YES | 汇率模式0 美金到目标币种,1目标币种到美金 | 1 |
参数示例
curl --location --request POST 'http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createTransaction' \
--header 'Content-Type: application/json' \
--data-raw '{
"sign": "5CC22598927472D70D1F59122EF2635E871E49C44BB469055534711E5C96485A",
"param": {
"epayAccount": "jing32@qq.com",
"transactionType": "C2C",
"category": "BANK",
"notifyUrl": "http://192.168.2.6:8380/openapi/apiForward/callBack",
"merchantOrderNo": "te3ssd7383d334523t128a",
"amount": "10",
"receiveAmount": "",
"settlementCurrency": "USD",
"receiveCurrency": "CNY",
"version": "V2.0.0",
"channelCode": "51",
"senderInfo": {
"surName": "wang",
"givName": "wu",
"idType": "2",
"idNumber": "452245645634534523",
"purposeOfRemittance": "6",
"birthday": "1992-12-28",
"city": "Santa Clara",
"zipCode": "58039",
"address": "Santa Clara, CA 3050 Bowers Avenue",
"country": "US",
"accountNo":"13721473389"
},
"receiverInfo": {
"surName": "li",
"givName": "lei",
"nationality": "CN",
"country": "CN",
"area": "",
"accountNo": "13721473389",
"idNumber":"1234567890"
}
}
}'
RequestExample
curl --location --request POST 'http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createTransaction' \
--header 'Content-Type: application/json' \
--data-raw '{
"sign": "5CC22598927472D70D1F59122EF2635E871E49C44BB469055534711E5C96485A",
"param": {
"epayAccount": "jing32@qq.com",
"transactionType": "C2C",
"category": "BANK",
"notifyUrl": "http://192.168.2.6:8380/openapi/apiForward/callBack",
"merchantOrderNo": "te3ssd7383d334523t128a",
"amount": "10",
"receiveAmount": "",
"settlementCurrency": "USD",
"receiveCurrency": "CNY",
"version": "V2.0.0",
"channelCode": "51",
"senderInfo": {
"surName": "wang",
"givName": "wu",
"idType": "2",
"idNumber": "452245645634534523",
"purposeOfRemittance": "6",
"birthday": "1992-12-28",
"city": "Santa Clara",
"zipCode": "58039",
"address": "Santa Clara, CA 3050 Bowers Avenue",
"country": "US",
"accountNo":"13721473389"
},
"receiverInfo": {
"surName": "li",
"givName": "lei",
"nationality": "CN",
"country": "CN",
"area": "",
"accountNo": "13721473389",
"idNumber":"1234567890"
}
}
}'
ResponseExample
{
"sign": "9AF49E2564C829418BBC7FE43F4BAC55E9F848B6C886AF5EF637B598D96CFFEF",
"epayAccount": "jing32@qq.com",
"version": "V2.0.0",
"code": 1,
"message": "success",
"data": {
"category": "BANK",
"merchantOrderNo": "te3ssd7383d334523t128a",
"epayOrderNo": "211151598521901746507776",
"status": "9",
"amount": "10.0",
"settlementCurrency": "USD",
"receiveAmount": "70.6",
"receiveCurrency": "CNY",
"rate": "0.141647",
"fee": "1.5",
"extendFields": null,
"rateMode": "1"
}
}