收银台创建

请求地址

method	url
POST	/api/checkout/payment/create

头部信息（header）

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

请求参数

字段	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
paymentType	Int	no		支付方式，支付方式: 1:VA 4:PayCashOnce 5:PayCashRecurrent 6:OXXO
expirationTime	String	no		按默认是一天；最短时间为10分钟最长为20天；Xm：分钟（如 90m 表示 90 分钟）,Xh：小时（如 2h 表示 2 小时）,Xd：天数（如 5d 表示 5 天）
amount	String	yes	20	金额
realName	String	yes	50	名字 ,全大写
phone	String	no	10	手机号
email	String	no	50	用户邮箱
callbackUrl	String	no	200	回调地址
sign	String	yes		签名

请求示例

{
    "merchantOrderNo": "OrderNoExample",
    "amount": "1000",
    "callbackUrl": "https://www.callbackexample.com",
    "realName":"TeemoPay",
    "sign": "YOUR_SIGN"
}

返回参数

参数	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
tradeNo	String	yes		平台订单号
amount	String	yes		订单交易金额
status	Int	yes		代收状态,0:受理中 3-失败
checkoutLink	String	no		收银台地址
expirationTime	String	no		收银台地址过期时间
errorMsg	String	no		错误信息,失败时返回

返回示例

{
    "msg": "success",
    "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
    "code": 200,
    "data": {
        "amount": "1000.00",
        "tradeNo": "TS2501010001MX0000000000000000",
        "expirationTime": "2025-01-01 00:00:00",
        "checkoutLink": "https://mx-payin.teemopay.com/#/?tradeNo=TS2501010001MX0000000000000000",
        "merchantOrderNo": "OrderNoExample",
        "status": 0
    }
}

错误码

异常码	异常信息	处理方案
412	Please try again later	请稍后重试
414	*	更改对应参数
416	Application not found	app_code异常，请更改
424	This payment method is not configured	代收方式未配置，请联系我们配置对应代收方式
426	merchant order duplicate	请更换商户订单号
427	The callback notification address for collection must not be empty.	未配置代收回调地址，请配置代收回调地址
460	The current payment method is unavailable.	当前代收方式不可用，请更换
464	Mexican mobile phone numbers must be 10 digits.	墨西哥手机号码校验为10位
472	Invalid format for expireTime. Allowed format: [number][m/h/d]	过期时间配置异常，请检查
473	Merchant joint verification error: *	配置异常，请联系我们
500	Business Error	请联系我们

返回示例

{
    "code": 426,
    "data": null,
    "msg": "merchant order duplicate",
    "traceId": "f2b58c9c394d4b1595dd4e448ac741bc.2256.17645844263770017"
}