创建代收

请求地址

method	url
POST	/api/pay/payment/create/v1

头部信息（header）

header 参数	入参参数描述
timestamp	请求时间戳
nonce	随机值
country	ID
app_code	app 编号

支持支付方式列表（paymentType）

支付方式名称	PaymentType (入参参数)
PaymentLink	501(收银台,包含所有可用的支付方式,E-Wallet,VA,QRIS)
E-Wallet	502(收银台,包含电子钱包的支付方式,Dana等)
VA	503 (收银台,包含Va的支付方式,BNI等)
QRIS	504 (收银台,包含QRIS的支付方式)
QRIS-Direct	505 (QRIS直连支付方式)
VA-Direct	506 (VA直连支付方式)

支持支付方式扩展列表（channel）

支付方式	channel
503	BRI,MANDIRI,CIMB
502	DANA,LINKAJA
506	BRI,MANDIRI,CIMB

• 仅当payment为502和503时channel字段有效

请求参数

字段	类型	必需	最大长度	描述
merchantOrderNo	String	yes	32	商户订单号
paymentType	Int	yes		支付方式: 501,502,503,504,505,506
amount	String	yes	20	代收金额,印尼盾,整数
realName	String	yes	64	用户姓名
email	String	yes	50	用户邮箱：满足正则表达式即可
phone	String	yes	13	电话号码 08开头,10~13位
channel	String	no		支付方式扩展字段,当特定支付方式为502,503,506必传,详情请见【支持支付方式扩展列表】
sign	String	yes		签名
callbackUrl	String	no	200	回调地址
redirectUrl	String	no	255	当有结果时，客户可以跳转该地址

{
  "merchantOrderNo": "OrderNoExample",
  "realName": "TeemoPay",
  "amount": "60000",
  "callbackUrl": "https://www.callbackexample.com",
  "paymentType": 502,
  "email": "TeemoPay@example.com",
  "channel": "DANA",
  "phone": "0800000000",
  "sign": "YOUR_SIGN"
}

返回参数

字段	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
tradeNo	String	yes	32	平台订单号
amount	String	yes	32	交易金额
paymentType	Int	yes	3	支付方式
paymentInfo	String	yes	32	主要付款信息，返回的是实际用于付款的信息，例如：付款编号
additionalInfo	JSONObject	no		扩展信息
status	Int	yes		1-订单创建成功 3-失败
errorMsg	String	no		错误信息,失败时返回

{
  "msg": "success",
  "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
  "code": 200,
  "data": {
    "amount": "60000.00",
    "tradeNo": "TS2501010001ID0000000000000000",
    "additionalInfo": {

    },
    "merchantOrderNo": "OrderNoExample",
    "paymentInfo": "https://www.paymentLinkExample.com",
    "paymentType": 502,
    "status": 1
  }
}

错误码

异常码	异常信息	处理方案
412	Please try again later	请稍后重试
414	*	更改对应参数
423	This payment method is not supported	对应支付方式不支持，请查阅文档，如存在则联系我们配置
426	merchant order duplicate	请更换商户订单号
427	The callback notification address for collection must not be empty.	请配置代收回调地址
465	channel not support	更换支付方式/渠道
466	Payment method fee rate not configured.	商户代收费率配置异常，请联系我们
473	Merchant joint verification error: *	商户配置异常，请联系我们
500	Business Error	请联系我们

返回示例

{
    "code": 423,
    "data": null,
    "msg": "This payment method is not supported",
    "traceId": "0801113131dd4951a36d19022a31b303.94.17423567008990449"
}