Partner API v1

Integra pagos institucionales
en horas, no meses.

Un endpoint de eventos, webhooks firmados con HMAC, sandbox aislado y paso a producción sin intervención manual. Diseñado para PSPs, exchanges, bancos, fintechs, ERPs y payroll.

Empezar →Ver documentación

Eventos idempotentes

Envía estados on-chain, conversiones y settlements. Nunca se procesa dos veces (por eventId o transactionId+status).

Webhooks firmados

HMAC-SHA256, reintentos con backoff, replay e histórico completo con status, tiempo y payload.

Sandbox real

Base aislada con sk_test_. Simula eventos y webhooks sin tocar datos reales.

Seguridad institucional

Bearer + firma + nonce + timestamp + IP allow-list + scopes + rate limit. Secretos nunca en claro.

Integrado al Settlement

Cada evento alimenta Timeline, Compliance, Treasury, Auditoría y el Notification Center.

OpenAPI + SDKs

Explorer moderno y ejemplos en curl, PHP, Node, Python, Java, Go y C#.

curl -X POST https://settlement.mercantil.com.do/api/v1/partners/events \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "X-Mercantil-Timestamp: $TS" -H "X-Mercantil-Nonce: $NONCE" \
  -H "X-Mercantil-Signature: $SIG" -H "Content-Type: application/json" \
  -d '{"eventId":"evt_9f8a72","transactionId":"txn_88213","status":"ON_CHAIN_DEPOSIT_RECEIVED","occurredAt":"2026-09-11T04:12:07+00:00","amount":"1000","currency":"USDC"}'