Коста-Рика

Коста-Рика имеет одну из самых надежных финансовых систем в Центральной Америке с высоким уровнем проникновения банковских услуг и растущей цифровой экономикой. Потребители знакомы с карточными платежами и банковскими переводами, и все чаще используются платежные точки на основе наличных для удобства и доступности.

В этой среде предложение разнообразных способов оплаты имеет важное значение для улучшения пользовательского опыта и максимального успеха транзакций. Наша платформа позволяет вам:

• Принимать платежи по кредитным и дебетовым картам через крупные международные бренды, такие как Visa и Mastercard.
• Упрощать банковские переводы через Banco Nacional, надежное и широко используемое местное учреждение.

Поддержка этих вариантов помогает вам завоевать доверие, расширить охват и обеспечить бесперебойные платежи на рынке Коста-Рики.

подсказка

Обратите внимание, что процесс всегда один и тот же: перед обработкой транзакции необходимо создать заказ, вот пример тела заказа для этой страны.

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

доход

SINPE Móvil

Способ оплаты SINPE MÓVIL позволяет пользователям в Коста-Рике совершать платежи, используя номер телефона, привязанный к банковскому счету. Эта услуга требует подтверждения типа и номера идентификации клиента, а также номера телефона.

Общий процесс

1. Продавец отправляет запрос на оплату в наш API с необходимыми параметрами.
2. Мы отвечаем информацией об оплате и ссылкой urlCheckout.
3. Продавец перенаправляет пользователя по этой ссылке для заполнения формы и получения инструкций по оплате.
4. Пользователь совершает оплату через свой банк, а затем должен нажать «Подтвердить оплату» на странице оформления заказа.
5. Мы подтверждаем оплату и уведомляем продавца через webhook.

---

Пример запроса

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

Пример ответа

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

---

Кредитные и дебетовые карты

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
card+	credit	tc	Visa, Mastercard

Полная транзакция – тело (образец запроса)

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

---

Банковский перевод

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
bankin	bank	banco-nacional	Banco Nacional

Полная транзакция – тело (образец запроса)

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

---

Наличные

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

Полная транзакция – тело (образец запроса)

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

---

Кошелёк

PayPal

Этот endpoint позволяет инициировать процесс оплаты через PayPal с использованием нашего API.
Мы сгенерируем URL для оформления заказа (checkout), на который клиент сможет быть перенаправлен для безопасного завершения процесса оплаты.

Завершение транзакции - Тело запроса (Пример)

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

Дополнительные примечания

• Продавец должен перенаправить пользователя на URL payer-action сразу после получения ответа.
• Не полагайтесь только на перенаправление пользователя для подтверждения оплаты; всегда проверяйте окончательный статус оплаты, используя webhook.

---