创建订单
参数说明
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"
}
}