Get Started

Overview

The NTX Pay Mexico API lets your company execute payment operations, reconcile transactions, and receive webhook notifications — all in a secure and scalable way. Authentication uses an X.509 certificate (mTLS) + OAuth 2.0, returning a short-lived JWT for each request.

Step by Step in the Sandbox

Request a sandbox account

Contact your account manager or write to contact@ntxpay.com to request a sandbox account.

Receive your credentials

You will receive a certificate and the OAuth credentials (clientId + clientSecret) associated with the sandbox account.

curl -X POST https://sandbox.mx.ntxpay.com/api/webhooks-config \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://meu-servidor.com/webhooks/ntxpay",
    "events": ["cash_in"]
  }'

Authenticate and simulate scenarios

Authenticate, make API calls, and use the X-Sandbox-Scenario header to simulate different outcomes (immediate confirmation, failure, expiration, etc.).

curl -X POST https://sandbox.mx.ntxpay.com/api/spei/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Sandbox-Scenario: rejected" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCentavos": 50000,
    "externalId": "order-001",
    "customerName": "Juan Perez",
    "customerEmail": "juan@example.com"
  }'

Environment

Environment	URL
Sandbox	`https://sandbox.mx.ntxpay.com`
Production	`https://api.mx.ntxpay.com`

Integration Path

Authentication

Certificate + OAuth 2.0 to obtain the JWT

SPEI Cash-In

Receive payments via a disposable CLABE

Webhooks

Receive notifications for every event

Sandbox

Test scenarios and simulated webhooks

Support

suporte@ntxpay.com

Guide

Sandbox

Webhooks

Authentication

SPEI

Webhooks Config

Overview

Step by Step in the Sandbox

Environment

Integration Path

Authentication

SPEI Cash-In

Webhooks

Sandbox

Support

​Overview

​Step by Step in the Sandbox

​Environment

​Integration Path

Authentication

SPEI Cash-In

Webhooks

Sandbox

​Support

Overview

Step by Step in the Sandbox

Environment

Integration Path

Support