GridZen · CEP Verify

用 REST、网页和 MCP 接入同一个 CEP 流程

不同入口应共用同一个商户任务,切换入口不应重复核验或改变结果含义。

保留唯一请求

提交前创建 UUID,保留原正文与 UUID。相同 UUID 修改交易字段会返回幂等冲突。超时先按原 UUID 查询任务。

金额单位是 MXN 整数分,100 表示 1 MXN;机构使用五位代码。首发商户入口接受合法的 18 位 CLABE,历史功能支持卡号不意味着本入口已开放卡号。

资料不要放进 URL

商户 API Key 放在 Authorization,请求字段放 JSON 正文。密钥及请求文件保存在私有位置。Agent 调用前也必须取得业务资料处理授权。

MCP、REST 与网页使用同一任务,无隐藏代付或独立免费额度;读取已有结果不会再次查询上游。

解释结构化结果

分别检查签名、各项交易绑定及姓名结果,将任务编号关联业务订单。原件走本租户受保护下载,不生成永久公开的银行资料链接。下面的示例需要你自己的获授权文件,不包含可执行的真实付款样本。

# Submit only an existing, authorized payment. Store the request locally.
# cep-request.json fields:
# idempotency_key (UUID), operation_date (YYYY-MM-DD), tracking_key,
# amount_minor (integer MXN cents), issuer_code, receiver_code (5 digits),
# account (18-digit CLABE), expected_name (optional), business_website,
# authorization_reference (UUID), authorized_to_query: true,
# purpose: "payment_reconciliation", terms_version: "cep-existing-payment-2026-10-22".
curl --fail-with-body https://gridzen.ai/console/api/payment-evidence/mx/cep/checks \
  -H "Authorization: Bearer ${GRIDZEN_API_KEY:?set your merchant key locally}" \
  -H "Content-Type: application/json" --data-binary @cep-request.json
# 202 returns a durable task id. Preserve the UUID after a timeout.
# GET /console/api/payment-evidence/mx/cep/requests/{original_idempotency_key}
# GET /console/api/payment-evidence/mx/cep/checks/{id}
# GET /console/api/payment-evidence/mx/cep/checks/{id}/original
# No payout is created. Never submit a made-up or unapproved transaction.

Banco de México · CEP / SPEI · GridZen CEP Verify

企业邮箱验证后可试用;每企业域名累计 10 次,全站每天 50 次。当前免费,正式收款尚未启用。

试用 CEP Verify