Costa Rica Digital Voucher
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
Channel
Optional Fields
| Field | Description | Validation |
|---|---|---|
| network | Digital banking network. If omitted, a generic digital banking flow can be used. | See network code values below |
Networks
| Name | Code | Minimum amount | Maximum amount |
|---|---|---|---|
| Banca Digital Banco Nacional de Costa Rica | banco_nacional_banca_digital | 1,100 CRC | 538,000 CRC |
| Banco Popular Banca Digital | banco_popular_banca_digital | 1,100 CRC | 538,000 CRC |
| Banco Promerica Banca Web | promerica_banca_web | 1,100 CRC | 538,000 CRC |
Expiry
Payment Instructions
1.
2.
3.
4.
1.
2.
3.
4.
5.
1.
2.
3.
4.
5.
1.
2.
3.
4.
5.
payment_method_reference (the 16-digit PayCash reference) as the reference number to enter in your bank's digital banking.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 1000,
"country": "CR",
"currency": "CRC",
"customer_ip": "120.29.48.92",
"fields": {
"network": "banco_nacional_banca_digital"
},
"merchant_customer_id": "customer@email.com",
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0001",
"payment_method": "digital_voucher",
"return_urls": {
"failure_url": "https://merchant.com/payment-failure",
"success_url": "https://merchant.com/payment-success"
}
}'Response Response Example
{
"expires_at": "2026-06-12T09:27:00Z",
"instructions": {},
"payment_method_reference": "7041621293386808",
"transaction_id": "20260205-1127-4678-8883-5e4868d33e4e"
}Modified at 2026-10-19 14:06:50