Costa Rica Checkout for WooCommerce

No. SINPE Móvil does not offer a public API to verify transfers, so the store checks the receipt and its bank account and confirms the payment manually.

Yes. The Central Bank (BCCR) limits SINPE Móvil payments made by SMS to ₡100,000 per day, and the limit in bank apps depends on each bank (usually up to ₡500,000). Set a maximum amount per order in the SINPE Móvil settings so the method is not offered for larger orders.

No. The exchange rate comes from the Ministerio de Hacienda by default, which needs no credentials. A BCCR token is only needed if you prefer the Central Bank's service. You can generate it in the BCCR economic indicators site, under My profile → Generate token.

First enable the Exchange rate module: without it, SINPE Móvil is not offered in stores that sell in dollars. The customer pays the order total converted to colones with the exchange rate of the day (sell rate by default), plus your optional surcharge, rounded up to whole colones. The amount and the rate are saved in the order, so later rate changes do not affect it.

In wp-content/uploads/crkit-receipts/, with random file names. They are not in the Media Library and are only served through a protected link that checks the user's permissions, so they stay private on Apache and on Nginx.

Yes. Copy the files from the plugin's templates folder to yourtheme/costa-rica-checkout-for-woocommerce/ and edit them there.

From the official 2025 administrative division of Costa Rica (Decreto Ejecutivo 44882-MGP, published in Alcance 12 to La Gaceta 17 on January 28, 2025). The postcode is the official code of the district: province (1 digit) + canton (2) + district (2).

The block checkout only allows extra fields that do not depend on each other. After the province, customers choose the district from a list of that province's districts, shown as "Canton — District" and sorted by canton (it is a regular dropdown without search); the canton is saved as the city automatically.

No. For Costa Rican addresses the canton and district are chosen at checkout, where shipping is calculated again. The shipping calculator on the classic cart page does not show them, so rates that depend on the postcode are only exact at checkout. This is a known limitation.

Yes. The canton is saved in the standard city field and the district code in the standard postcode field, so shipping zones by postcode and other plugins can use them. The district is also stored as order meta (_billing_crkit_district and _shipping_crkit_district).

No. The ID number module stores the customer's ID type and number so that your electronic invoicing plugin can use them.

With crkit_get_order_identification( $order ), which returns type (Hacienda's code: 01 cédula física, 02 cédula jurídica, 03 DIMEX, 04 NITE), type_label, number (without hyphens or spaces) and electronic_invoice (whether the customer asked for one), or null. The crkit_order_identification_saved action fires when a customer places an order with an ID. The values are stored as order meta _wc_other/crkit/id-type, _wc_other/crkit/id-number and _wc_other/crkit/electronic-invoice.

Yes, without asking for an electronic invoice. Checkout offers the four ID types that people and companies in Costa Rica use: cédula física, cédula jurídica, DIMEX and NITE. Hacienda's "Extranjero No Domiciliado" and "No Contribuyente" types are only valid on specific receipts, so they are not offered. If you sell abroad, keep the ID as "Required only if the customer asks for an electronic invoice" or "Optional": with "Required", a customer without one of these IDs cannot place an order.

The minified JavaScript in assets/build is built with @wordpress/scripts from the readable sources in assets/src, which ship with the plugin. The PHP code is not minified. The full source, build tools and tests are on GitHub: https://github.com/arielcr/costa-rica-checkout-for-woocommerce

No. There is no public check digit, so the plugin only checks the format of each type. It does not look the number up in any registry.