Pay-ins
Deja que tus clientes paguen como ya se paga en su mercado.
Ofrece en el checkout los medios de pago locales disponibles, recibe la confirmación mediante las actualizaciones de cada transacción y conecta los fondos que entran con el resto de tu operación.
- Un endpoint: POST /api/payin/
- Moneda local, un solo saldo
- Webhooks firmados para cada estado
- Países con pay-ins
- 9
- Países con cuentas virtuales
- 7
- Países con tarjetas: Argentina, Colombia, México y Perú
- 4
- Estado en tiempo real de cada pago
- Webhooks
El desafío
Cobrar desde el exterior deja dinero sobre la mesa
Las tarjetas internacionales son solo una parte. En la región se paga con transferencia y QR, y cada país lo hace a su manera.
Cobrar sin un socio local
- Solo tarjetasMuchos compradores prefieren transferencias o QR, y abandonan si no las tienen.
- Una integración por paísCada mercado tiene sus propios rieles, documentos, límites y reglas.
- Conciliación manualCruzar a mano pagos de varios proveedores es lento y propenso a errores.
Cobrar con Localpayment
- Los medios que la gente ya usaPix, PSE, Bre-B, CVU, CLABE, QR y marcas locales de tarjeta en una sola integración.
- Un esquema para todos los paísesLos mismos campos en todas partes: country, currency, amount, paymentMethod, externalId.
- Un saldo, un reporte, un formato de webhookCada cobro se acredita en tu cuenta y se concilia en los mismos reportes.
Medios de pago
Medios locales disponibles, un solo endpoint.
Elige los medios que prefiere cada mercado. La solicitud no cambia: solo el código del medio de pago, el país y la moneda.
Tarjetas
- ar
- co
- mx
- pe
Visa y Mastercard en Argentina, Colombia, México y Perú, además de American Express, Naranja y Cabal en Argentina y American Express y Diners Club en Colombia.
Tarjetas —Cuentas virtuales
- ar
- br
- cl
- co
- cr
- mx
- pe
Una CVU, llave Pix, CLABE, CCI, IBAN, llave Bre-B o número de cuenta chileno dedicado por cliente, factura o pedido.
Cuentas virtuales —Medios de pago locales (APMs)
- ar
- bo
- br
- cl
- co
- gt
- pe
Pix en Brasil, PSE en Colombia, Debin y QR en Argentina, ETPAY en Chile, QR en Bolivia y Perú, y QR Fri y Wallet Fri en Guatemala.
Medios de pago locales (APMs) —Suscripciones
- co
- mx
- pe
Planes programados o cobros bajo demanda con reintentos configurables.
Suscripciones —
Flujo del dinero
Del checkout a tu saldo
Una solicitud crea el pago; el riel local lo confirma; un webhook firmado avisa a tu plataforma.
- 1
ClienteTu plataforma:
Elige un método local
Pix, SPEI, PSE, Bre-B, tarjetas o cualquier método disponible en el país.
- 2
Tu plataformaLocalpayment:
POST /api/payin/
Monto, moneda, país y datos del pagador en una sola solicitud.
- 3
LocalpaymentCliente:
Instrucciones de pago
Código QR, llave, referencia o redirección, según el método.
- 4
ClienteRiel local / banco:
Paga en la app del banco
El pagador autoriza con su propio banco o billetera.
- 5
Riel local / bancoLocalpayment:
El riel confirma
Los rieles en tiempo real confirman en segundos; los demás siguen sus propios horarios de corte.
- 6
LocalpaymentTu plataforma:
Webhook firmado
Tu sistema libera la orden y el saldo se acredita.
Flujo ilustrativo. El tiempo de confirmación y los horarios de corte dependen del método y del país.
Cómo funciona
De la solicitud al saldo en cuatro pasos
- 01
Solicitud
POST /api/payin/ con el país (ISO-3), la moneda, el monto, el paymentMethod y tu externalId único.
- 02
El cliente paga
Las tarjetas se autorizan en tiempo real. Las cuentas virtuales y los medios de pago locales se confirman de forma asíncrona.
- 03
Webhook
Un webhook firmado con HMAC-SHA256 trae el resultado, tu externalId y nuestro internalId.
- 04
Saldo acreditado
El cobro se acredita en tu cuenta de Localpayment en tu moneda de liquidación, normalmente USD.
Ciclo de vida
Gestiona todo el ciclo del pago
Todo lo que pasa después del pago ocurre en la misma plataforma, por API o desde el Business Portal.
- Reembolsos de pagos con tarjeta, cuenta virtual y APM
- Gestión de contracargos con carga de evidencia por API
- Cancelación de pagos APM pendientes antes de que el pagador apruebe
- Descarga de comprobantes de reembolso
- Checkouts dinámicos con el endpoint Get Available Payment Methods
- FX en el momento del pago, con la tasa bloqueada mediante un token de cotización
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Para desarrolladores
Un endpoint, campos específicos por país.
Autentícate con POST /api/token/ y llama al mismo endpoint Create Payin para cualquier país, con los campos que ese país requiere. Este ejemplo de Pix devuelve un código QR y se confirma por webhook.
- Tokens Bearer: acceso de 5 minutos y refresh de 24 horas
- Tu externalId en cada solicitud; los duplicados devuelven HTTP 409
- Stage replica producción sin dinero real
# 1) Obtén un token de acceso (Stage). Guarda las credenciales en un gestor de secretos.
curl -X POST https://api.stage.localpayment.com/api/token/ \
-H "Content-Type: application/json" \
-d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }'
# 2) Crea un pay-in Pix (valores ficticios)
curl -X POST https://api.stage.localpayment.com/api/payin/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"paymentMethod": { "type": "BankTransfer", "code": "1314", "flow": "DIRECT" },
"externalId": "7c1e2f7a-0000-4000-8000-000000000001",
"country": "BRA",
"currency": "USD",
"amount": 100,
"accountNumber": "<your-account-number>",
"conceptCode": "0003",
"merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" },
"payer": {
"type": "INDIVIDUAL",
"name": "Maria",
"lastname": "Silva",
"document": { "type": "CPF", "id": "000.000.000-00" }
}
}'Cobertura
Medios de pay-in por país
Argentina
- Cuentas virtuales
- CVU
- Tarjetas
- Sí
- Medios locales
- QR · Debin
Bolivia
- Cuentas virtuales
- —
- Tarjetas
- —
- Medios locales
- QR
Brasil
- Cuentas virtuales
- Cuenta virtual (Pix o TED)
- Tarjetas
- —
- Medios locales
- Pix
Chile
- Cuentas virtuales
- Cuenta bancaria (TEF)
- Tarjetas
- —
- Medios locales
- ETPAY
Colombia
- Cuentas virtuales
- Llave Bre-B
- Tarjetas
- Sí
- Medios locales
- PSE
Costa Rica
- Cuentas virtuales
- IBAN (SINPE)
- Tarjetas
- —
- Medios locales
- —
Guatemala
- Cuentas virtuales
- —
- Tarjetas
- —
- Medios locales
- QR Fri · Wallet Fri
México
- Cuentas virtuales
- CLABE
- Tarjetas
- Sí
- Medios locales
- —
Perú
- Cuentas virtuales
- CCI
- Tarjetas
- Sí
- Medios locales
- QR
Fuente: guías por país en docs.localpayment.com. La disponibilidad se confirma para cada comercio durante el onboarding.
Casos de uso
Cobros pensados para cada industria
E-commerce y marketplaces
Tarjetas, Pix, PSE y SPEI en el checkout, con reembolsos desde la misma API.
E-commerce y marketplaces —Bienes digitales y streaming
Los rieles instantáneos confirman en segundos y el contenido se desbloquea al instante.
Bienes digitales y streaming —SaaS
Cobra suscripciones en local y liquida en tu moneda fuerte.
SaaS —Viajes
Tickets altos por transferencia bancaria con confirmación en tiempo real.
Viajes —
Preguntas frecuentes
¿Cuál es mi moneda de liquidación?
Normalmente USD. Los cobros en moneda local se acreditan en tu cuenta de Localpayment en tu moneda de liquidación. También puedes convertir saldos locales a otras monedas fuertes, como EUR o GBP, dentro del horario del mercado local.
¿Los pagos se confirman en tiempo real?
Las autorizaciones con tarjeta son en tiempo real. Los rieles en tiempo real como Pix, SPEI, COELSA, TEF, CCE y Bre-B confirman en segundos, 24/7. Los demás medios se confirman de forma asíncrona, y cada estado final llega por webhook.
¿Cómo sé que un pago se completó?
Recibes un webhook firmado con HMAC-SHA256 en el encabezado X-Signature. Un status.code 200 significa COMPLETED. También puedes consultar GET /api/transactions/{externalId}/status.
¿Puedo reembolsar un pago?
Sí. Los pagos con tarjeta, cuenta virtual y APM se pueden reembolsar por API o desde el Business Portal.
¿Necesito una integración distinta por país?
No. La estructura de la solicitud es la misma en todas partes; los nuevos mercados se habilitan por configuración, sin reintegrar.
¿Cómo empiezo a probar?
Las credenciales de Stage se entregan al inicio de la relación comercial. Stage replica producción sin dinero real, así que puedes probar cada flujo antes de salir en vivo.
¿Qué métodos de pago puedo ofrecer en cada país?
Tarjetas en Argentina, Colombia, México y Perú, y cuentas virtuales y medios de pago locales (APMs) donde estén documentados por país. El directorio de métodos de pago lista cada método, código y velocidad; tu equipo de cuenta los habilita por configuración.
¿Puedo cobrar en dólares?
En algunos mercados sí: por ejemplo cuentas virtuales en USD en Costa Rica, Perú y México (vía SPID). En la mayoría de los países el pagador paga en moneda local y el cobro se acredita en tu cuenta en tu moneda de liquidación.
También en la misma API
Cuentas virtuales
Un número de cuenta local único por cliente, conciliado automáticamente.
Cuentas virtuales —Payouts
Pagos a cuentas bancarias por rieles locales en 14 países y a billeteras en 9.
Payouts —Conciliación y reportes
Reportes, APIs y webhooks para equipos de finanzas.
Conciliación y reportes —
Empieza a cobrar localmente
Recibe credenciales de Stage al inicio de la relación, sal en vivo en semanas y abre nuevos mercados por configuración.

Un endpoint: POST /api/payin/