Costa Rica

Costa Rica cuenta con uno de los sistemas financieros más sólidos de Centroamérica, con una alta tasa de bancarización y una economía digital en crecimiento. Los consumidores están familiarizados con los pagos con tarjeta y las transferencias bancarias, y el uso de puntos de pago en efectivo es cada vez mayor por su comodidad y accesibilidad.

En este contexto, ofrecer una amplia gama de métodos de pago es fundamental para mejorar la experiencia del usuario y maximizar el éxito de las transacciones. Nuestra plataforma le permite:

• Aceptar pagos con tarjeta de crédito y débito a través de las principales marcas internacionales como Visa y Mastercard.
• Facilitar transferencias bancarias a través del Banco Nacional, una institución local confiable y ampliamente utilizada.

Apoyar estas opciones le ayuda a generar confianza, aumentar la cobertura y garantizar pagos sin inconvenientes en el mercado costarricense.

tip

Tenga en cuenta que el proceso es siempre el mismo, antes de procesar la transacción debe crear la orden, aquí hay un ejemplo del cuerpo de la orden para este país.

{
    "country": "CRI",
    "origin": "api",
    "amount": "600",
    "email": "test@gmail.com"
}

Pagos

SINPE Móvil

El método de pago SINPE MÓVIL permite a los usuarios en Costa Rica realizar pagos utilizando su número telefónico asociado a una cuenta bancaria. Este servicio requiere una validación del tipo y número de identificación del cliente, así como su número telefónico.

Flujo general

1. El comercio envía la solicitud de pago a nuestra API con los parámetros requeridos.
2. Respondemos con la información del pago y una urlCheckout.
3. El comercio redirige al usuario a esa URL para que complete los datos e instrucciones.
4. El usuario realiza el pago en su banco y luego debe presionar "Confirmar pago" en el checkout.
5. Confirmamos el pago y notificamos al comercio vía webhook.

Ejemplo de solicitud

{
  "hash": "U2FsdGV...",
  "paymentMethod": "sinpemovil",
  "typePayment": "bank",
  "typeTransaction": "bankin",
  "urlReturn": "https://www.youtube.com",
  "urlWebhook": "https://www.url.com/ok"
}

Ejemplo de respuesta

{
  "status": {
    "code": 202,
    "message": "success",
    "kind": "unknown"
  },
  "data": {
    "reference": "AH***",
    "urlWebhook": "https://www.url.com/ok",
    "urlReturn": "https://www.youtube.com",
    "payment": {
      "uuid": "b5***",
      "merchant": "merchant...",
      "country": "CRI",
      "origin": "api",
      "status": "processing",
      "createdAt": "2025-08-11T23:42:31.000Z",
      "type": "bankin",
      "amount": 600,
      "rejectionReason": null,
      "sandbox": 1,
      "currency": "",
      "paymentMethod": "sinpemovil",
      "typeMethod": "bank",
      "merchantId": null,
      "referencia": "AH***",
      "ID_COMERCIO": null,
      "urlWebhook": "https://www.url.com/ok",
      "urlReturn": "https://www.youtube.com"
    }
  },
  "urlCheckout": "https://checkout..."
}

---

Tarjeta de crédito

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
card+	credit	tc	Visa, Mastercard

Completar transacción - Cuerpo (Solicitud de muestra)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod": "tc",
    "typePayment": "credit",
    "typeTransaction": "card+",
    "description": "Promo 2",
    "merchantId": "123sas-46564s-45454-123",
    "urlReturn": "https://google.com",
    "urlWebhook": "https://url.com/ok"
}

---

Transferencia bancaria

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
bankin	bank	banco-nacional	Banco Nacional

Completar transacción - Cuerpo (Solicitud de muestra)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod" : "banco-nacional",
    "typePayment" : "bank",
    "typeTransaction":"bankin",
    "description" : "Test order",
    "customer": {
        "typeDocument":"CC",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Pérez",
        "phoneNumber":"3133133131"
    },
    "address": {
        "line1": "123 First Street",
        "city": "Alajuela",
        "postalCode": "32830"
    },
}

---

Cash

Type Transaction	Type Payment	Payment Method	Supported Providers	Logos
cashin	cash	puntoshey	Puntos Hey
		payser	Payser

Completar transacción - Cuerpo (Solicitud de muestra)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod" : "puntoshey",
    "typePayment" : "cash",
    "typeTransaction":"cashin",
    "description" : "Test order",
    "customer": {
        "typeDocument":"CC",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Perez",
        "phoneNumber":"3133133131"
    },
    "address": {
        "line1": "123 First Street",
        "city": "Alajuela",
        "postalCode": "32830"
    },
}

---

Billetera

PayPal

Este endpoint permite iniciar un proceso de pago con PayPal a través de nuestra API.
Generaremos una URL de checkout a la que el cliente podrá ser redirigido para completar de forma segura el proceso de pago.

Completar transacción - Body (Ejemplo de solicitud)

{
  "hash": "U2FsdGV...",
  "paymentMethod": "paypal",
  "typePayment": "wallet",
  "typeTransaction": "walletin",
  "merchantId": "564153131",
  "urlReturn": "https://google.com",
  "urlRejected": "https://youtube.com",
  "urlWebhook": "https://webhook/ok"
}

Notas adicionales

• El comercio debe redirigir al usuario a la URL de payer-action inmediatamente después de recibir la respuesta.
• No se debe confiar únicamente en la redirección del usuario para confirmar el pago; siempre se debe validar el estado final del pago utilizando el webhook.

---

Limites

💡 Nota: Los valores expresados en esta sección de "Límites" están en USD.

Cash

Minimo	Maximo	Min. Transacciones Diarias	Max. Transacciones Diarias
2 USD	368 USD	No aplica limites	9.999

Transferencia Bancaria

Minimo	Maximo	Min. Transacciones Diarias	Max. Transacciones Diarias
2 USD	1042 USD	No aplica limites	9.999