Saltar al contenido

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.

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

    ClienteTu plataforma:

    Elige un método local

    Pix, SPEI, PSE, Bre-B, tarjetas o cualquier método disponible en el país.

  2. 2

    Tu plataformaLocalpayment:

    POST /api/payin/

    Monto, moneda, país y datos del pagador en una sola solicitud.

  3. 3

    LocalpaymentCliente:

    Instrucciones de pago

    Código QR, llave, referencia o redirección, según el método.

  4. 4

    ClienteRiel local / banco:

    Paga en la app del banco

    El pagador autoriza con su propio banco o billetera.

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

  1. 01

    Solicitud

    POST /api/payin/ con el país (ISO-3), la moneda, el monto, el paymentMethod y tu externalId único.

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

  3. 03

    Webhook

    Un webhook firmado con HMAC-SHA256 trae el resultado, tu externalId y nuestro internalId.

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

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.

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.

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.

¿Cómo podemos ayudarte?

Descarga tu ejemplar

Déjanos tus datos y obtén la edición completa al instante.