Skip to content

一、集成步骤概括

商户通过直接与PayerMax服务端交互的方式进行下单请求,通过该服务,商户可在移动Web集成印度、印尼、菲律宾等国多种在线收款方式,如借记卡、信用卡、电子钱包等,轻松具备印度业务收款能力。

1.调用API请求下单

2.根据PayerMax返回的URL,打开H5收银台供用户支付

3.接收异步回调通知,根据支付结果处理订单 API+H5收款

二、API下单接口参数说明

请求和响应数据格式:application/json

1.请求参数

参数类型是否必填最大长度描述示例值
merchantIdString30PayerMax分配给商户的唯一标识SP12345678
bizTypeString30对应所签约的收款服务权限,可问询商务,印度跨境传"IN_CB",其他地区传"CUSTOMIZE"IN_CB
versionString5接口版本。当前值为:2.32.3
signString64采用MD5字符串签名,DD6F959727F2724B7FFTY164DFF036F1
orderIdString64商户订单号,只能包含字母、数字、下划线。每次调用下单时不能重复1535433516669
userIdString64商户用户IDZNW3e
subjectString256订单标题,用于收银台界面显示,建议传入商品名称3510Gigs
countryCodeString10国家代码,大写字母,如果所传的国家码与币种不匹配,则以币种对应的地区展示收银台,IN
currencyString3货币代码,大写字母,INR
totalAmountString12商户传入的交易金额,取值范围:[1,100000000],小数点后最多支持2位。 注意:印尼、台湾地区不支持带小数金额。 150.00
frontCallBackUrlString256商户指定的跳转URL,用户完成支付后会被跳转到该地址,以http/https开头https:
callbackUrlString256服务端回调通知URL,在商户平台配置后可不传,以http/https开头https:
descriptionString256订单附加说明recharge 3510 Gigs
+ paymentDetailString256定义支付方式信息,如正确传入可跳过付款人信息搜集页。内容是Json格式字符,{"paymentType":"00","accountNo":"test@yesbank"}
└ paymentTypeString20支付方式编码,参见【各国收款方式列表 - paymentType Code】 ,定义'paymentType'后,可跳过支付方式选择页,直接进入指定支付方式的信息录入页;如果没有设置此参数,则直接进入收银台首页,展示所有支付方式 00
└ accountNoString64支付账号,针对部分钱包和UPI支付可以在下单参数中 传入账号信息缩短用户的支付流程,详情参见【账号字段说明】test@yesbank
+ userDetailString512供商户提交付款人信息,如正确传入可跳过付款人信息搜集页。内容是Json格式字符。 各地区参数参见【UserDetail填写规则】{"name":"CustName","email":"com@iup","phoneNumber":"50000000","districtCode":"965"}
└ nameString45付款人姓名5-45位,凡支付渠道需用户填写姓名,将默认取该值供用户便利选择
└ emailString32付款人邮箱,凡支付渠道需用户填写邮箱,将默认取该值供用户便利选择xxx@gmail.com
└ phoneNumberString15付款人手机号,凡支付渠道需用户填写手机号,将默认取该值供用户便利选择9101234123
└ districtCodeString付款人手机的国际区号
└ citizenIdNoString10为付款人身份证件号EBZPV8569H
└ deviceIdString付款人设备标识
└ ipString付款人设备IP地址127.0.0.1
referenceString512可供商户自定义,且在回调中反馈的字段item157
languageString8 语言设置,小写字母,用来指定收银台的展示语言,如果不传,我们会结合用户的实际情况提供适合的语言来展示收银台,参见en
showResultString8是否使用PayerMax支付结果页0:不使用1:使用1
expireTimeString10订单有效时长,单位为秒,该字段仅在bizType=CUSTOMIZE并且是印度地区时有效。最长可定义至72小时,默认30分钟(1800秒)。 此字段仅在countryCode为“IN”时生效 1800

请求报文:

json
{
  "merchantId": "SP12345678",
  "bizType": "IN_CB",
  "version": "2.3",
  "sign": "DD6F959727F2724B7FFFE164DFF7756F1",
  "orderId": "1535433513349",
  "userId": "ZNW3e",
  "subject": "3510 Gigs",
  "countryCode": "IN",
  "currency": "INR",
  "totalAmount": "150.00",
  "frontCallBackUrl": "https://****.com/redirect/developer.html",
  "callbackUrl": "https://****.com/payermax/rechargeNotify",
  "description": "recharge 3510 Gigs",
  "paymentDetail": "{\"paymentType\":\"00\",\"accountNo\":\"test@yesbank\"}",
  "userDetail": "{\"name\":\"James\",\"phoneNumber\":\"95562642\"}",
  "reference": "Item157",
  "language": "en",
  "showResult": "1",
  "expireTime": "1800"
}

2.响应参数

参数类型是否必返最大长度描述示例值
bizCodeString10返回码0000
dataObject返回数据体,由**公共参数和特定参数**组成,详见下方的【data参数】
messageString256返回描述,接口报错原因提示

data参数

2.1.公共参数

参数类型是否必返最大长度描述示例值
tradeNoString64payermax平台订单号TRADE20190815020832881447141
orderIdString64商户订单号15354453516149
requestUrlString1024跳转结果地址https://****.com/redirect/developer.html
statusNumber2订单状态:0-待支付,1-支付成功,2-支付失败0
signString64采用MD5字符串签名,DB73C116DE2F220A68BB96542885E171

响应报文:

json
{
  "data": {
    "tradeNo": "TRADE20190815055232111447141",
    "orderId": "1535433533149",
    "requestUrl": "http://cashier-dev.payermax.com/index.html#/paySDKH5/cashierH5?merchantId=SP4189603&token=HrUbWDQkd6jcFp68AW2N7DOOHjb%2F9kh7RkljKNaLR7sgSfxVG5TvBbW89RNX%2ByQIU8P9auBWBCskuJJQxtO9HNZ%2BwhMG8lYR7l12k3%2FLaP%2BxhLEBDOjICucJS1bASn0V&tradeNo=TRADE20190815020832111447141&identifyId=8641043&language=en&usePayResultType=1&frontCallBackUrl=https%3A%2F%2Fxxx.com%2Fredirect%2Fdeveloper.html",
    "status": 0,
    "sign": "DB73C116DE2F220A68BB96567885E171"
  },
  "bizCode": "0000"
}

响应参数处理示例

js
//响应成功
if(bizCode == "0000"){
    if(status == 0){
        //跳转到requestUrl
    } else if(status == 1){
        //支付成功
    } else {
        //支付失败
    }
}

2.2.特定参数

特定参数在指定场景下返回,目前仅限于下指定方式为 印度尼西亚运营商 时返回。 该运营商参数,适用于需要自行包装支付引导画面的商户使用。如商户无此需求,可忽略该参数。详情可参阅 【运营商参数】

3.UserDetail填写规范

参数名地区描述示例
citizenIdNo印度为付款人的Pan卡号,10位数EBZPV8569H
巴西为付款人的CPF卡号,11位数字007.408.869-67
智利为付款人的CI卡号, 8-9位数字
哥伦比亚为付款人的CC卡号, 6-10位数字
墨西哥为付款人的CURP卡号,10-18位字符,含数字或字母
秘鲁为付款人的DNI卡号, 8-9位数字
巴拉圭为付款人的CI卡号,5-20位数字
乌拉圭为付款人的CI卡号,6-8位数字

4.产品编码

bizType服务权限名称
CUSTOMIZE自定义API收款
IN_CB印度跨境收款

三、账号字段说明

对API下单接口请求参数字段【accountNo】的说明

下述支付方式,如正确传入对应的accountNo,可跳过PayerMax收银台,直接进入对应的支付页面,缩短用户操作路径。

地区支付类型指定支付方式备注
印度UPIUPI collect'accountNo' 字段需传入用户 UPI 账号
钱包Paytm Wallet'accountNo' 字段需传入用户 Paytm 账号
FreeCharge'accountNo' 字段需传入用户 FreeCharge 手机号

四、特定参数-运营商参数

1.当请求参数paymentType 取值为 Telkomsel 下单成功时将返回运营商参数如下:

参数类型是否必返最大长度描述示例值
carrierBillingJson运营商参数
└ keyWordString32关键字REDS10K
└ smsCodeString16短信代码39351
└ shortCodeString16收件人99899
└ phoneNumberString32手机号码081329041338

响应代码举例

json
{
  "bizCode": "0000",
  "message": "success",
  "data": {
    "orderId": "20200724072000000009910",
    "requestUrl": "https://cashier-alpha.shareitpay.in/index.html#/sms/instruction?merchantId=M36977092608&orderId=20200724072000000002410&countryCode=ID&language=en&tradeNo=TM000600202007290000001170430000&token=3T147T%2Fl0bGBb1g6IB33x9LwkCqUCH3nOWogtrxORXNsN71KJBHvMIWyf%2BG1el%2FS0TzHf73x9PORt3YN%2FghALnoaFc%2FzwUVn2Ok7q79oaVrSnNNCgAnZjB35CKgQaK%2Fo&identifyId=9738338&usePayResultType=0&frontCallBackUrl=http%3A%2F%2Fwww.baidu.com&payOrderNo=CP000600202007290000000550750000¤cy=IDR&preTaxAmount=5000.00&afterTaxAmount=5500.00&phoneNumber=081329041338&smsKeyword=REDS5K&smsCode=46421&smsShortCode=99899&smsType=0",
    "tradeNo": "TM000600202007290005501170430000",
    "status": 0,
    "sign": "AB73C116DE2F130A67BB965428995E564",
    "carrierBilling": "{\"phoneNumber\":\"0813290413638\",\"smsCode\":\"46421\",\"shortCode\":\"99899\",\"keyWord\":\"REDS5K\"}"
  }
}

2.当请求参数paymentType 取值为 Tri、XL、Smartfren、Indosat 下单成功时将返回运营商参数如下:

参数类型是否必返最大长度描述示例值
carrierBillingJson运营商参数
└ phoneNumberString32手机号码081329041333

响应代码举例

json
{
  "bizCode": "0000",
  "message": "success",
  "data": {
    "orderId": "20200724072000000055414",
    "requestUrl": "http://cashier-dev.shareitpay.in/index.html#/sms/instruction?merchantId=SP12345678&orderId=20200724072000000055414&countryCode=ID&language=en&tradeNo=TM014900202007296600004501170000&token=SdNY%7GzFsRKX91MTzQMCiB5Em0unfUXPy6oqmtgnTqtLRcItAzxoTccs%2BJD9CW57UhiIJAY2X8y3XVrTxJE%2FNhmBp1NtX4wZgsYlLnw%2BTG2Abrvb4xOLPu4tDSqhv7KC6&identifyId=9738338&usePayResultType=0&frontCallBackUrl=http%3A%2F%2Fwww.baidu.com&payOrderNo=CP014900202007290000005670090000¤cy=IDR&preTaxAmount=5000.00&afterTaxAmount=5688.00&phoneNumber=087803428358&smsKeyword=&smsCode=&smsShortCode=&smsType=1",
    "tradeNo": "TM014900202007290000004661170000",
    "status": 0,
    "sign": "DB73C116DE2F220A67BB96542849E175",
    "carrierBilling": "{\"phoneNumber\":\"087803447320\"}"
  }
}

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.