API Todaypay
Home
官网
登录
登录
  • OMS后台-拉美
  • OMS后台-亚洲
Home
官网
登录
登录
  • OMS后台-拉美
  • OMS后台-亚洲
  1. 墨西哥
  • 开发指南
    • 集成指引
    • API接口说明
    • API 签名
    • Postman 和 SDK
    • WebHook 介绍
    • 订单状态说明
    • API 错误码
    • PCI 合规性
  • 交易接口
    • 北美洲
      • 美国
        • 收款
        • 出款
      • 墨西哥
        • 收款
          POST
        • 出款
          POST
    • 南美洲
      • 巴西
        • 收款
        • 出款
      • 哥伦比亚
        • 收款
        • 出款
      • 厄瓜多尔
        • 收款
        • 出款
      • 阿根廷
        • 收款
        • 出款
      • 秘鲁
        • 收款
        • 出款
      • 智利
        • 收款
        • 出款
      • 委内瑞拉
        • 收款
        • 出款
    • 亚洲
      • 印度尼西亚
        • 收款
        • 出款
      • 菲律宾
        • 收款
        • 出款
      • 泰国
        • 收款
        • 出款
      • 马来西亚
        • 收款
        • 出款
      • 孟加拉
        • 收款
        • 出款
      • 印度
        • 收款
        • 出款
      • 巴基斯坦
        • 收款
        • 出款
    • 欧洲
      • 俄罗斯
        • 收款
        • 出款
    • 中东
      • 阿联酋
        • 收款
        • 出款
      • 土耳其
        • 收款
        • 出款
    • 非洲
      • 肯尼亚
        • 收款
        • 出款
      • 尼日利亚
        • 收款
        • 出款
      • 南非
        • 收款
        • 出款
      • 坦桑尼亚
        • 收款
        • 出款
    • 全球卡支付
      • 收款
      • 出款
  • 公共接口
    • 凭证查询
      POST
    • 余额查询
      POST
    • 订单状态查询
      POST
  • 支付视频
    • 支付视频
    • 支付方式 LOGO
  • 商户平台
    • 绑定 2FA Code
  • 数据模型
    • 收款公共 req body
    • 收款公共 res data
    • 出款公共 req body
    • 出款公共 res data
Home
官网
登录
登录
  • OMS后台-拉美
  • OMS后台-亚洲
Home
官网
登录
登录
  • OMS后台-拉美
  • OMS后台-亚洲
  1. 墨西哥

收款

开发中
POST
/gateway/base/biz
墨西哥代收用户信息暂可以不用填真实信息
dynamic: 非必要字段
dynamic = 4
因为墨西哥用户有保存CLABE账号多次付款的情况,如果商户需要接受订单(支付金额和下单金额不一致)且接受多次支付,可以传4(账号一直有效),当用户真实多次支付,每一笔真实支付都会立即通知回调商户
dynamic = 4,当用户保存clabe账号多次支付支付成功,回调参数通知中包含区分每笔实际支付的金额 realAmount,初始下单的商户订单号 mchOrderId ,每笔支付订单的 bankId 唯一,可以作为防重和生成新单的防重单号,商户必须对 bankId 做防重校验,实际回调案例如下:
{
    "realAmount": "15.0",
    "orderType": "PAYMENT",
    "bankId": "CUS_375a18092921:ACC_4ef39ec5c22_1",
    "amount": "15.0",
    "createTime": "20240226031455",
    "orderId": "202402251761952537422222222F",
    "transIds": "TRX",
    "orderStatus": "SUCCESS",
    "mchOrderId": "M0023",
    "failMessage": "Create F-pay order for the real amount. "
}
{
    "realAmount": "10.0",
    "orderType": "PAYMENT",
    "bankId": "CUS_375a18092921:ACC_4ef39ec5c22_2",
    "amount": "10.0",
    "createTime": "20240226031954",
    "orderId": "2024022517619525374222233232F",
    "transIds": "TRX",
    "orderStatus": "SUCCESS",
    "mchOrderId": "M0023",
    "failMessage": "Create F-pay order for the real amount. "
}

提高成功率建议#

iframe 嵌套的页面,如果浏览器版本较低可能会导致收银台复制粘贴功能不能用,墨西哥用户的浏览器版本比较低,这个也是降低成功率的首要问题,iframe可以设置以下方式解决:
<iframe  allow="clipboard-read; clipboard-write"></iframe>

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200PAYMENT-BANKTRNSFER-成功
application/json
Body

🟢200PAYMENT-OXXO_PAY
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/gateway/base/biz' \
--header 'method: pay' \
--header 'signType: SHA512' \
--header 'serviceName: api.pay' \
--header 'mchId: 1416010331032883200' \
--header 'timestamp: 1631671670' \
--header 'sign: 32554324534545432543' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchOrderId": "string",
    "amount": "string",
    "firstname": "string",
    "currency": "string",
    "lastname": "string",
    "productinfo": "string",
    "email": "string",
    "phone": "string",
    "callbackUrl": "string",
    "redirectUrl": "string",
    "noPayPage": "string",
    "dynamic": "string",
    "paymentType": "SPEI"
}'
响应示例响应示例
200 - PAYMENT-BANKTRNSFER-成功 - 示例 1
{
    "data": [
        {
            "beneficiaryAccountNumber": "string",
            "orderId": "string",
            "refNumber": "string",
            "expirationTime": "string",
            "beneficiaryName": "string",
            "beneficiaryAccountType": "string",
            "beneficiaryBankName": "string",
            "beneficiaryBankBranchId": null,
            "document": null,
            "beneficiaryBankCode": "string",
            "ispb": null,
            "checkoutUrl": "string"
        }
    ],
    "resultCode": "string",
    "errorCode": "string",
    "errorMsg": "string"
}
修改于 2025-09-03 18:34:20
上一页
出款
下一页
出款
Built with