💵提交订单

法币下单,商户可以通过支付链接引导用户跳转至 UPay 的 Ramp 收银台付款。在用户支付成功后,系统将即时进行回调通知

请求地址:/v1/api/open/ramp/apply

请求方式:POST

请求类型:application/json

请求参数:

字段名称
字段类型
是否必填
是否签名
示例值
说明

appId

string(8)

Zu78qwe1

APP ID

merchantOrderNo

string(14-32)

Order202409291231

商户端自主生成的订单号,在商户端要保证唯一性

chainType

string(1)

1

链路:

1: 波场(TRC20)

2: 以太坊(ERC20)

attach

string(64)

自定义

用户自定义数据,在回调到 notifyUrl 的时候会原样返回

toAddress

string(32-64)

TAsnassdajsadjasdjxxxxxxxxxxxxx

商户收款地址

notifyUrl

string(256)

https://callbacknotify.com/callback

接收异步通知的回调地址。必须为可直接访问的 URL,不能带参数、session 验证、csrf 验证

redirectUrl

string(256)

https://productdetail.com

支付成功后,前端重定向地址。务必包含 http:// 或 https:// 开头

products

[]array

products示例

商品列表

signature

string(32)

6F3B90783FABE56DBB771D03E0EAADD0

数据签名,详见:签名算法

products:

字段名称
字段类型
是否必填
是否签名
示例值
说明

name

string(64)

T-shirt

商品名称

description

string(128)

goods desc

商品描述

quantity

string(3)

1

数量

fiatAmount

string(10)

699

单价,法币金额,精确到小数点后 2 位

fiatCurrency

string(3)

JPY

法币ISO代码,支持的币种

返回值 data 参数:

字段名称
字段类型
说明

orderNo

string

UPay 订单号

merchantOrderNo

string

商户订单号

payUrl

string

收银台地址,商户可直接跳转到该地址供用户支付

Last updated