创建收款单（墨西哥）

创建墨西哥比索（MXN）收款订单接口。

请求资讯

请求 URL： /gateway/api/v2/payments
请求方式： POST
Content-Type： application/json;charset=utf-8

请求参数

参数名	必选	类型	说明
platform_id	是	String(6)	商户 ID
service_id	是	String(7)	服务 ID，固定值 `SVC0122`
payment_cl_id	是	String(64)	商户订单号
amount	是	Integer(10)	金额（分，centavo）
notify_url	是	String(256)	交易结果通知地址
name	否	String(64)	付款人姓名（建议传入，见备注）
request_time	是	Integer(10)	请求时间（秒）
sign_type	否	String(16)	签名类型，固定值 `HMAC-SHA256`
sign	是	String(32\|64)	订单签名

服务 ID

SVC0122 SPEI银行转账(墨西哥通道)

返回示例

成功返回

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 50000,
    "card_name": "DEMO ACCOUNT",
    "card_number": "002010077777777771",
    "bank_name": "DEMO BANK",
    "payment_cl_name": "JUAN PEREZ"
  }
}

返回参数说明

参数名	类型	说明
error_code	String	错误码，详见全局错误码
error_msg	String	错误讯息（error_code 不为 "0000" 时返回）
link	String	订单收银台地址
payment_id	String	平台订单号
payment_cl_id	String	商户订单号
amount	Int	提单金额
card_name	String	收款账户名
card_number	String	收款帐号（18 位 CLABE）
bank_name	String	收款银行名称
payment_cl_name	String	付款人姓名，即建单传入的 `name` 原样回带

备注

交易金额单位为墨西哥比索（分，centavo），请乘以 100 传入，例如收款 500.00 MXN 请传值 50000
付款人须通过 SPEI 转账至返回的收款帐号（18 位 CLABE），每笔订单产生专属收款帐号，无需填写转帐附言
建议建单时带入 name（付款人姓名）；本服务要求必填付款人姓名，若商户未提供，系统会先将付款人导向中转页面填写姓名，完成后再继续原支付流程；此时建单返回不含收款帐户资讯（card_name / card_number / bank_name），请将付款人导向 link
取得 link 后可将付款人导向该收银台页面，页面会显示收款帐户资讯
请求时间使用 Unix timestamp，单位为秒
交易结果将通知至 notify_url，请传入可公开访问之完整地址（仅支援 http 与 https 协议），参数规范见交易结果通知
订单最终状态请以查询收款单或交易结果通知为准

请求资讯​

请求参数​

服务 ID​

返回示例​

成功返回​

返回参数说明​

备注​

请求资讯

请求参数

服务 ID

返回示例

成功返回

返回参数说明

备注