Costa Rica

Costa Rica has one of the most solid financial systems in Central America, with a high banking penetration rate and a growing digital economy. Consumers are familiar with card payments and bank transfers, and there's an increasing use of cash-based payment points for convenience and accessibility.

In this environment, offering a diverse range of payment methods is essential to improve user experience and maximize transaction success. Our platform enables you to:

• Accept credit and debit card payments through major international brands like Visa and Mastercard.
• Facilitate bank transfers via Banco Nacional, a trusted and widely used local institution.

Supporting these options helps you build trust, increase coverage, and ensure seamless payments in the Costa Rican market.

tip

Please note that the process is always the same, before processing the transaction you must create the order, here is an example of the body for this country.

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

Pay In

SINPE Móvil

The SINPE MÓVIL payment method allows users in Costa Rica to make payments using their phone number linked to a bank account. This service requires validation of the customer's identification type and number, as well as their phone number.

General flow

1. The merchant sends the payment request to our API with the required parameters.
2. We respond with the payment information and a urlCheckout.
3. The merchant redirects the user to that URL to complete the form and payment instructions.
4. The user makes the payment through their bank and then must click "Confirm Payment" in the checkout.
5. We confirm the payment and notify the merchant via webhook.

---

Request Example

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

Sample Response

{
  "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..."
}

Credit Cards

Type Transaction	Type Payment	Payment Method	Supported Providers	Logos
card+	credit	tc	Visa, Mastercard

Complete transaction - Body (Sample Request)

{
    "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"
}

---

Bank Transfer

Type Transaction	Type Payment	Payment Method	Supported Providers	Logos
bankin	bank	banco-nacional	Banco Nacional

Complete transaction - Body (Sample Request)

{
    "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

Complete transaction - Body (Sample Request)

{
    "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"
    },
}

---

Wallet

Paypal

This endpoint allows you to initiate a payment process with PayPal through our API.
We will generate a checkout URL where the customer can be redirected to securely complete the payment process.

Complete transaction - Body (Sample Request)

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

Aditional Notes

• The merchant must redirect the user to the payer-action URL immediately after receiving the response.
• Do not rely solely on user redirection to confirm the payment; always validate the final payment status using the webhook.

---

Limits

💡 Note: The values expressed in this "Limits" section are in USD.

Cash

Minimum	Maximum	Min. Daily Transactions	Max. Daily Transactions
2 USD	368 USD	No limits apply	9.999

Bank Transfer

Minimum	Maximum	Min. Daily Transactions	Max. Daily Transactions
2 USD	1042 USD	No limits apply	9.999