Costa Rica
Learn everything you need to know to make payouts in Costa Rica with dLocal.
Market specifications
Take a look of all the information you need to make a payout.
Country reference Document validations Mandatory paramentersBank information
Find all the bank account validations details you need to make a payout.
Bank account validationsMarket specifications
Do you want to know more information about Costa Rica's market? Go to the Tap Into Latin America’s High-Growth Potential article.
Country reference
country code | currency code | amount decimals | document_type name | document_id format |
---|---|---|---|---|
CR | CRC | 2 | CI | 9 digits |
Document validations
Validation | Name | Length | Type | Verification digit | Example |
---|---|---|---|---|---|
Document | CI | 9 | numeric | No | 123456789 |
Document | CJ | 10 | numeric, starting with "3" | No | 3001999999 |
Document | CR | 12 to 22 | numeric, starting with "1" | No | 1234567890155566 |
Mandatory parameters
Bank transfers
Bank transfer parameters | B2C | B2B | USD accounts | P2P |
---|---|---|---|---|
login | Yes | Yes | Yes | Yes |
pass | Yes | Yes | Yes | Yes |
external_id | Yes | Yes | Yes | Yes |
document_id | Yes | Yes | Yes | Yes |
document_type | Yes | Yes | Yes | Yes |
beneficiary_name | Yes | Yes | Yes | Yes |
beneficiary_lastname | Yes | Yes | Yes | Yes |
country | Yes | Yes | Yes | Yes |
currency | Yes | Yes | Yes | Yes |
bank_account | Yes | Yes | Yes | Yes |
amount | Yes | Yes | Yes | Yes |
address | Yes | Yes | Yes | Yes |
currency_to_pay | - | - | Yes | - |
purpose | - | - | - | Yes |
remitter_full_name | - | - | - | Yes |
remitter_country | - | - | - | Yes |
remitter_document_type | - | - | - | Yes |
remitter_document | - | - | - | Yes |
Payment methods
Costa Rica supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.
Bank transfers
Bank transfers in Costa Rica require detailed account information, including document ID, document type, bank account, amount, and address. The format of these fields depends on the receiving bank, and strict validation rules apply.
Refer to the document validations and bank account validations sections for format specifications.
Mandatory parameters
All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
document_id | Document ID of the beneficiary. See document validations below. |
document_type | Document type: CI (cédula de identidad), CJ (cédula jurídica), CR (cédula de residencia). See document validations. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. |
beneficiary_lastname | Last name of the beneficiary. Maximum 50 characters. |
country | Country code. For Costa Rica, use CR . |
currency | Payout currency. For Costa Rica, use CRC or USD . |
bank_account | Bank account number. See bank account validation below. |
amount | Payout amount. Use up to 2 decimal numbers. |
address | Full address. Maximum 200 characters. |
currency_to_pay | Currency to be paid out. USD . Mandatory only if the payout needs to be paid in USD. In case this parameter is missing, the payout will be paid in local currency. |
purpose | Reason for the payout. EPREMT - Remittance (P2P). Mandatory only for remittance (P2P). |
remitter_full_name | Full name of the sender. Maximum 200 characters. Mandatory only for remittance (P2P). |
remitter_country | ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P). |
remitter_document_type | Type of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (P2P). |
remitter_document | Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P). |
Example request
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "1234567812345678b",
"document_id": "123456789",
"document_type": "CI",
"country": "CR",
"bank_account": "12345678912345678",
"currency": "CRC",
"amount": "2000.00",
"beneficiary_name": "JUAN",
"beneficiary_lastname": "RUIZ",
"address": "calle 12# 12A - 12, La fortuna",
"type": "json"
}
Bank information
Access the reference formats and accepted values required for processing bank payouts in Costa Rica.
Updated 6 days ago