| 接口说明 | 汇款预下单。正式提交汇款前,预先提交汇款相关信息,系统返回并锁定汇率。 | |||
| 接口地址 | https://api.moni.im/transfer/api/v1/precreate_send | |||
| 测试接口地址 | https://testwebapi.omipay.com.cn/transfer/api/v1/precreate_send | |||
| 请求参数 | 参数名称 | 类型 | 属性 | |
| send_currency | String | 必录,汇款货币 | ||
| send_amount
(暂不需要) |
Decimal | 汇款金额
l 若该字段不为空,则receive_amount字段不生效 l 该金额为汇款人包含手续费总共需要支付的金额; |
||
| receive_amount | Decimal | 收款金额
该金额为OMIPAY会向收款人实际支付的金额,手续费及汇款金额会通过该金额反算得到。 |
||
| recipient_id | Long | 必录,收款人ID | ||
| send_reason | String | 必录,汇款原因
具体原因见《汇款原因》 |
||
| out_transaction_id | String | 非必录,外部交易编号
若该字段不为空,则商户需要保证其唯一性 |
||
| 返回值 | 名称 | 类型 | 说明 | |
| 成功返回 | is_success | Bool | 成功时返回true | |
| send_id | Long | 汇款订单ID | ||
| send_currency | String | 汇款币种 | ||
| receive_currency | String | 收款币种 | ||
| exchange_rate | Decimal | 汇率 | ||
| send_amount | Decimal | 实际汇款金额 | ||
| receive_amount | Decimal | 实际收款金额 | ||
| fee_amount | Decimal | 手续费金额(以汇款币种为单位)
金额及手续费计算公式见《手续费计费方式》 |
||
| 失败返回 | is_success | Bool | 失败时返回false | |
| error_code | String | 错误码 | ||
| error_msg | String | 错误信息 | ||
| 错误说明 | 错误码 | 说明 | ||
| RISKCONTROL_DENIED | 风控拒绝,不能创建汇款单 | |||
| SEND_REASON_ERROR | 汇款原因错误,请参见汇款原因列表 | |||
| SEND_AMOUNT_TOO_LITTLE | 汇款金额太小 | |||
| INSUFFICIENT_BALANCE | 账户余额不足 | |||
| CURRENCY_NOT_SUPPORT | 不支持的汇款币种 | |||
| DUPLICATE_OUT_TRANSACTION_ID | 重复的外部交易编号 | |||
![]()