# 代收

# 请求地址

环境	地址
测试环境	http://8.130.9.219:8899/api/supefina/transactions/payin
正式环境	https://api.supefina.net/api/supefina/transactions/payin

# 提交方式

采用POST方法提交

# 请求参数 - 墨西哥

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述	示例值
国家编号	countryId	是	String		- MEX：墨西哥
订单金额	orderAmount	是	String	- 传入100，为100 MXN - 传入最大/最小订单金额时，订单金额也必须传入且必须在区间金额内 - 传入最大/最小订单金额时，以区间金额进行校验
最小订单金额	minOrderAmount	否	String	- 传入100，为100 MXN
最大订单金额	maxOrderAmount	否	String	- 传入100，为100 MXN
重复付款	repeat	是	Boolean	是否支持重复款款（主要针对墨西哥clabe）
支付产品	payProduct	是	String		- ~~13：User free option~~ - 15：Clabe
商户编号	merId	是	String
货币	currency	否	String		- MXN：墨西哥比索
顾客名字	customerName	否	String
顾客邮箱	customerEmail	否	String
顾客电话	customerPhone	否	String
下游商户订单号	merOrderNo	是	String
订单描述	description	是	String	不能带特殊符号
顾客识别号	customerIdentification	是	String	身份证号或身份证明
顾客识别号类型	customerIdentificationType	否	String
签名	sign	是	String
应用主体名称	appName	否	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
公司名称	companyName	否	String
受益人	beneficiary	否	String
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 请求示例 - 墨西哥

{
    "countryId": "MEX",
    "currency": "MXN",
    "orderAmount": "100",
    "payProduct": "15",
    "merId": "8102000000420042",
    "userIdentification": "testid123456",
    "description": "transas12121dasdasda",
    "sign": "F30BB4E4B31DE055F53A8A53DD5121E2",
    "repeat": true,
    "merOrderNo": "123123",
    "nonceStr": "123123",
    "companyName": "公司名称",
    "beneficiary": "受益人",
    "customerIdentification": "659423028000000007"
}

# 请求参数 - 哥伦比亚

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述	示例值
国家编号	countryId	是	String		- COL：哥伦比亚
订单金额	orderAmount	是	String
支付产品	payProduct	是	String		08
商户编号	merId	是	String
货币	currency	是	String		- COP：哥伦比亚比索
顾客名字	customerName	是	String
顾客姓氏	lastName	否	String
顾客邮箱	customerEmail	是	String
顾客电话	customerPhone	是	String
下游商户订单号	merOrderNo	是	String
订单描述	description	否	String
顾客识别号	customerIdentification	是	String	身份证号或身份证明
顾客识别号类型	customerIdentificationType	否	String
签名	sign	是	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
顾客账户	customerAccount	支付产品为“08”时必填	String
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 请求示例 - 哥伦比亚

# 请求参数 - 秘鲁

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述	示例值
国家编号	countryId	是	String		- PER：秘鲁
订单金额	orderAmount	是	String
支付产品	payProduct	是	String
商户编号	merId	是	String
货币	currency	是	String
顾客名字	customerName	是	String
顾客姓氏	lastName	是	String
顾客邮箱	customerEmail	是	String
顾客电话	customerPhone	否	String
下游商户订单号	merOrderNo	是	String
订单描述	description	否	String
顾客识别号	customerIdentification	是	String	身份证号或身份证明
顾客识别号类型	customerIdentificationType	是	String
签名	sign	是	String
应用主体名称	appName	否	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
顾客账户	customerAccount	否	String
公司名称	companyName	否	String
受益人	beneficiary	否	String
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 响应

字段名	变量名	类型	描述	示例值
响应编码	code	String
响应信息	msg	String
响应数据	data
商户编号	merCode	String
随机字符串	nonceStr	String
商户订单号	merOrderNo	String
supefina订单号	supefinaOrderNo	String
订单金额	amount	BigDecimal
手续费	fee	BigDecimal
交易状态	transactionStatus	String		- 00：预下单 - ~~01：交易成功~~ - ~~02：交易失败~~ - ~~03：支付拒绝~~ - 04：下单失败
交易链接	url	String
付款参考	reference	String
付款参考标识符	identifier	String	墨西哥返回为clabe号

← 接入流程代付 →