API、MCP 与接入文档

核验已经发生的 SPEI 付款：取得原始 XML、检查签名、核对交易和收款户名。不会发起转账。

# 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.

GET /console/api/payment-evidence/mx/cep/checks/{id} · GET /console/api/payment-evidence/mx/cep/requests/{original_idempotency_key}

202 queued · 409 idempotency conflict · 429 trial limit · 503 upstream held

签名、交易绑定与姓名比对分别展示。历史户名不证明当前持有或证件身份；需复核和未找到不等于欺诈。