Market specifications

Take a look of all the payment methods available.

Country reference Cards supported Alternative Payment Method supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

BN Servicios PuntoXpress PayCash Sinpe and Sinpe Móvil

Market specifications

Do you want to know more information about Costa Rica's market? Go to the Unlock your local payment methods in Latin America article.

Country reference

`country` code	`currency` code	`document` name	`document` format	`document` required?
`CR`	`CRC`	CI	9 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`AE`	American Express	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DC`	Diners	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DI`	Discover	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`JC`	JCB	`CARD`	Credit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows
`CX`	BN Servicios	`TICKET`	Cash Payment	`REDIRECT`
`PU`	PuntoXpress	`TICKET`	Cash Payment	`REDIRECT`
`CY`	PayCash	`TICKET`	Cash Payment	`DIRECT` `REDIRECT`
`IO`	Sinpe and Sinpe Móvil	`BANK_TRANSFER`	Bank Transfer	`DIRECT` `REDIRECT`

Cards

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	American Express	Diners	Discover	JCB
Minimum amount	100 CRC	100 CRC	100 CRC	100 CRC	100 CRC	100 CRC	100 CRC	100 CRC
Refunds	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Recurring	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Descriptor	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

BN Servicios

BN Servicios is a service channel that allows customers to carry out transactions in real-time, securely, and conveniently, without having to queue at bank offices.

It facilitates payments in cash through the BN Servicio business network which includes convenience stores, supermarkets, hardware stores, pharmacies, and car wash businesses. It is a correspondent of Banco Nacional de Costa Rica one of the largest banks in Costa Rica.

Capabilities

	BN Servicios
Min. amount	1000 CRC
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`CRC` Transaction currency in ISO 4217.	Yes
`country`	String	`CR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`CX` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 1000,
    "currency": "CRC",
    "country": "CR",
    "payment_method_id": "CX",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "123456789",
        "address": {
            "country": "CR",
            "state": "San Jose",
            "city": "San Jose",
            "zip_code": "8858",
            "street": "Av. Principal",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "R-4-1c438f7b-a5de-49a0-83ba-dfm6bd9260fa",
    "amount": 1000,
    "currency": "CRC",
    "payment_method_id": "CX",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "country": "CR",
    "created_date": "2023-06-21T18:47:53.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-19feec6b-e77a-4d32-a279-23c5d57f549a"
}

Example ticket

BN Servicios UI built with the information in the example above.

PuntoXpress

PuntoXpress is a payment point and cash collector for basic services, mobile recharges, and all kinds of purchases.

Capabilities

	PuntoXpress
Min. amount	1000 CRC
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`CRC` Transaction currency in ISO 4217.	Yes
`country`	String	`CR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`PU` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 1000,
    "currency": "CRC",
    "country": "CR",
    "payment_method_id": "PU",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "123456789",
        "address": {
            "country": "CR",
            "state": "San Jose",
            "city": "San Jose",
            "zip_code": "8858",
            "street": "Av. Principal",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "R-4-813cc263-fd98-45c7-ba69-2d692sca68fc",
    "amount": 1000,
    "currency": "CRC",
    "payment_method_id": "PU",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "country": "CR",
    "created_date": "2023-06-22T18:40:34.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments/M-4188b6ec-4bf8-42c1-af01-3664c348538b"
}

Example ticket

Exprés UI built with the information in the example above. — PuntoXpress UI built with the information in the example above.

PayCash

PayCash is a payment system enabled in the main commercial chains and banks in Latin America, which allows customers to receive and process cash payments and transfers immediately.

Capabilities

	PayCash
Min. amount	1000 CRC
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`CRC` Transaction currency in ISO 4217.	Yes
`country`	String	`CR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`CY` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 1000,
    "currency": "CRC",
    "country": "CR",
    "payment_method_id": "CY",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "123456789",
        "address": {
            "country": "CR",
            "state": "San Jose",
            "city": "San Jose",
            "zip_code": "8858",
            "street": "Av. Principal",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-65dd4581-3e61-554r-a5b4-4c930fd28d21",
    "amount": 1000,
    "currency": "CRC",
    "payment_method_id": "CY",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "CR",
    "bank_transfer": {},
    "ticket": {
        "type": "CUSTOM",
        "reference": 2881686593231689,
        "expiration_date": "2023-06-17T23:59:59.000+0000",
        "provider_name": "apm-paycash",
        "provider_logo": "logo",
        "image_url": "https://pay.dlocal.com/gmf-apm/payments/M-567711dd-tt65-4d84-b01a-e31632c21e76",
        "amount": 1000,
        "currency": "CRC"
    },
    "created_date": "2023-05-11T22:09:03.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "notification_url": "http://merchantsite.com/notification/new"
}

Example ticket

PayCash UI built with the information in the example above.

Sinpe and Sinpe Móvil

Sinpe is a service channel that allows customers to carry out transactions in real-time, securely, and conveniently, without having to queue at bank offices.

Sinpe is a technological platform developed and managed by the Central Bank of Costa Rica, connecting the country’s financial entities and public institutions through a private telecommunication network. This network facilitates electronic cash transfers between accounts, regardless of the originating bank.

Capabilities

	PayCash
Min. amount	1000 CRC
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`CRC` Transaction currency in ISO 4217.	Yes
`country`	String	`CR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`IO` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	No
`payer.email`	String	Email of the payer.	No
`payer.document`	Number	Document of the payer.	No
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 1000,
    "currency": "CRC",
    "country": "CR",
    "payment_method_id": "IO",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "123456789",
        "address": {
            "country": "CR",
            "state": "San Jose",
            "city": "San Jose",
            "zip_code": "8858",
            "street": "Av. Principal",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-081cef84-77t5-4ad0-u776-a88579287cd6",
    "amount": 1000,
    "currency": "CRC",
    "payment_method_id": "IO",
    "payment_method_type": "BANK_TRANSFER",
    "payment_method_flow": "DIRECT",
    "country": "CR",
    "bank_transfer": {
        "bank_name": "ridivi",
        "beneficiary_name": "DLOCAL COSTA RICA, S.R.L.",
        "bank_account": "CR23090100000000105977",
        "bank_account2": "85-356225",
        "bank_account_label": "Cuenta IBAN",
        "bank_account2_label": "SINPE Móvil ",
        "reference": "1210724863760",
        "redirect_url": "https://pay.dlocal.com/gmf-apm/payments/M-31764783-2ab5-7uyy6-86be-e87def9...",
        "user_payment_amount": 10,
        "expiration_date": "2023-12-18T05:59:00.000+0000"
    },
    "ticket": {},
    "created_date": "2023-12-12T13:00:53.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "notification_url": "http://merchantsite.com/notification/new"
}