Costa Rica Cash Voucher

Production

https://api.paypaga.com

POST

/v2/transactions/pay-in

Channel

Cash

Optional Fields

Field	Description	Validation
network	Payment point network. If omitted, a generic cash payment point can be used.	See network code values below

Networks

Name	Code	Minimum amount	Maximum amount
Puntos Hey	puntos_hey	1,100 CRC	538,000 CRC
Agentes Unipuntos Banco Nacional (BN Servicios)	unipuntos_bn	1,100 CRC	No fixed cap
Tiendas Ekono Punto Físico	ekono	1,100 CRC	538,000 CRC
Banco Popular Agencias y Corresponsales	banco_popular_agencias_corresponsales	1,100 CRC	538,000 CRC

Expiry

Initiated transactions that are not completed, transition to an Expired state after 72 hours.

Payment Instructions

Network not specified (generic)

1.

Go to any of the following payment points: Puntos Hey, Agentes Unipuntos Banco Nacional, Tiendas Ekono, or Banco Popular (Agencias y Corresponsales).

2.

Tell the cashier you want to make a PayCash payment.

3.

Provide the 16-digit reference and the amount to pay.

4.

Complete the payment and keep your receipt.

Puntos Hey

1.

Go to a Hey point (find the nearest one at: https://puntoshey.com/).

2.

Ask the cashier to process a PayCash payment.

3.

Provide the 16-digit reference and the amount to pay.

4.

Receive your payment receipt.

Agentes Unipuntos Banco Nacional (BN Servicios)

1.

Go to an Agentes Unipuntos Banco Nacional point.

2.

Ask the cashier to process a PayCash payment.

3.

The cashier looks up PayCash directly by name, or via: Pagos -> Cuotas y créditos -> Cuotas-Ahorro-Crédito -> PayCash.

4.

Provide the 16-digit reference and the amount to pay.

Tiendas Ekono Punto Físico

1.

Go to an Ekono store.

2.

Ask the cashier to process a PayCash payment.

3.

The cashier looks up PayCash directly by name, or via: Pagos -> Cuotas y créditos -> Cuotas-Ahorro-Crédito -> PayCash.

4.

Provide the 16-digit reference and the amount to pay.

Banco Popular Agencias y Corresponsales

1.

Go to a Banco Popular branch or correspondent.

2.

Ask the cashier to process a PayCash payment.

3.

The cashier looks up PayCash directly by name, or via: Pagos -> Cuotas y créditos -> Cuotas-Ahorro-Crédito -> PayCash.

4.

Provide the 16-digit reference and the amount to pay.

The response does not include step-by-step instructions or the selected network; use payment_method_reference (the 16-digit PayCash reference) as the reference number to share with the cashier.

Request

Authorization

or

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Pay-in accepted.

Headers

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 5000,
    "country": "CR",
    "currency": "CRC",
    "customer_ip": "120.29.48.92",
    "fields": {
        "network": "puntos_hey"
    },
    "merchant_customer_id": "customer@email.com",
    "merchant_order_reference": "ORDER-2026-0027",
    "merchant_transaction_reference": "TRX-2026-0027",
    "payment_method": "cash_voucher",
    "return_urls": {
        "failure_url": "https://merchant.com/payment-failure",
        "success_url": "https://merchant.com/payment-success"
    }
}'

Response Example

{
    "expires_at": "2026-06-12T09:20:00Z",
    "instructions": {},
    "payment_method_reference": "7041621293386801",
    "transaction_id": "20260210-1140-4b91-9c04-6e5979d44f01"
}

Modified at 2026-10-19 14:07:01

Costa Rica Digital Voucher