跳到主要内容

创建出款单(阿联酋)

创建阿联酋迪拉姆(AED)出款订单接口,支援 AE IBAN 银行转账与 PAYBY / AANI / EMONEY / DUPAY 钱包。

请求资讯​

  • 请求 URL: /gateway/api/v2/payouts
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数​

参数名必选类型说明
platform_id是String(6)商户 ID
service_id是String(7)服务 ID,固定值 SVC0004
payout_cl_id是String(64)商户订单号
amount是Integer(10)金额(菲尔)
notify_url否String(256)交易结果通知地址
bank_name是String(16)银行/钱包代码,亦可传银行英文名称,银行列表
name是String(64)受款人户名
number是String(64)受款人帐号:银行转账传 IBAN,钱包传钱包帐号
iban条件String(34)阿联酋 IBAN(AE + 21 位数字,共 23 码),如 AE070331234567890123456。银行转账与 AANI 钱包必填;银行转账未传则以 number 进行 IBAN 校验;PAYBY / EMONEY / DUPAY 无需传入
phone_number条件String(11)受款人手机号(如 0501234567)。银行转账必填;钱包未传时以 number 代替
currency是String(3)固定值:aed
request_time是Integer(10)请求时间(秒)
sign_type否String(16)签名类型,固定值 HMAC-SHA256
sign是String(32|64)订单签名

「条件」表示视收款方式而定,详见下方备注。

服务 ID​

  • SVC0004 银行卡出款(以 bank_name 区分银行转账或钱包)

返回示例​

{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}

备注​

重要提示

如遇超时或 HTTP 500 错误,请以订单查询接口状态为依据,不可直接视为订单失败。

  • 交易金额单位为阿联酋迪拉姆(菲尔)
  • 银行转账:bank_name 传银行代码或英文行名,iban 须为合法阿联酋 IBAN(AE + 21 位数字,共 23 码),phone_number 必填
  • 钱包(PAYBY / AANI / EMONEY / DUPAY):bank_name 传 PAYBY、AANI、EMONEY 或 DUPAY,number 传钱包帐号,银行列表
    • PAYBY:钱包帐号为 5 开头的 9 位数字
    • AANI:钱包帐号为 5 开头的 9 位数字;须同时传入 iban(AE + 21 位数字)
    • EMONEY / DUPAY:钱包帐号为 5 开头的 9 位数字
  • 单笔金额限制:银行转账 200 – 10000 AED;钱包单笔限额以营运设定为准
  • 收款资讯校验不通过时于建单阶段即返回错误,不会产生订单
  • 返回 "0000" 仅代表接口调用成功,请调用查询接口确认结果