Market 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	`beneficiary.document.type` name	`beneficiary.document.id` format
`CR`	`CRC`	2	CI, CJ, CR	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
`external_id`	Yes	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes	Yes
`country`	Yes	Yes	Yes	Yes
`amount`	Yes	Yes	Yes	Yes
`currency`	Yes	Yes	Yes	Yes
`beneficiary.first_name`	Yes	Yes	Yes	Yes
`beneficiary.last_name`	Yes	Yes	Yes	Yes
`beneficiary.business_name`	-	Yes	-	-
`beneficiary.document.id`	Yes	Yes	Yes	Yes
`beneficiary.address.street`	Yes	Yes	Yes	Yes
`beneficiary.document.type`	Yes	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes	Yes
`currency_to_pay`	-	-	Yes	-
`remitter.first_name`	-	-	-	Yes
`remitter.last_name`	-	-	-	Yes
`remitter.nationality`	-	-	-	Yes
`remitter.document.id`	-	-	-	Yes
`remitter.document.type`	-	-	-	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
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or`P2P` (Person to Person).
`purpose`	Reason for the payout. See purpose codes reference.
`country`	Country code. For Costa Rica, use `CR`.
`amount`	Payout amount in `CRC`. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Costa Rica, use `CRC` or `USD`. Payouts are always paid in local currency to the beneficiary.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.document.id`	Beneficiary's document ID or number. See document validations below.
`beneficiary.address.street`	Beneficiary’s street address. Maximum 200 characters.
`beneficiary.document.type`	Document type: `CI` (cédula de identidad), `CJ` (cédula jurídica), `CR` (cédula de residencia). See document validations.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Format and prefixes vary by bank. See bank account validations below.
`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.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. 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).

Example request

{
  "external_id": "1234567812345678b",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "CR",
  "currency": "CRC",
  "amount": 2000.00,
  "beneficiary": {
    "document": {
      "id": "305271289",
      "type": "CI"
    },
    "first_name": "JUAN",
    "last_name": "RUIZ",
    "address": {
      "street": "Calle Callera"
    },
    "bank_account": {
      "account": "CR11015102820010556133"
    }
  }
}

{
  "external_id": "1234567812345678c",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "CR",
  "currency": "CRC",
  "amount": 2000,
  "beneficiary": {
    "first_name": "JUAN",
    "last_name": "RUIZ",
    "document": {
      "type": "CI",
      "id": "123456789"
    },
    "address": {
      "street": "Calle Callera"
    },
    "bank_account": {
      "account": "CR11015102820010556133"
    }
  },
  "remitter": {
    "first_name": "MARIA",
    "last_name": "GARCIA",
    "nationality": "US",
    "document": {
      "type": "PASS",
      "id": "1234567890"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Costa Rica.

Bank account validations

Validation	Name	Length	Type	Verification digit	Example
Bank account	IBAN	22	alpha -numeric	Apply verification algorithm	CR32011400007914077990