Addi, Kueski Pay and Aplazo for OpenCart 2.3, 3.x and 4.x — pay in instalments in Colombia and Mexico

Addi, Kueski Pay and Aplazo is an OpenCart module with three buy now, pay later payment methods: Addi for Colombia (COP) and Kueski Pay and Aplazo for Mexico (MXN). The buyer applies on the provider’s page, the shop receives the full amount, and the buyer pays the provider in instalments.

The buyer coming back to the shop proves nothing: an order becomes paid only on Addi’s callback with the agreed user and password, or on the status the module itself reads from the Kueski Pay or Aplazo API. The free version: all three methods, “Check connection”, Kueski Pay limits from the account, decline and waiting pages. Pro: refunds from the order page, asking the provider again, a payment watchdog and a journal. Module languages: English and Spanish.

What the buyer sees

Each method shows only in its currency and within its limits: Addi to buyers browsing in COP, Kueski Pay and Aplazo in MXN; Kueski Pay hides above the account limit. For Addi the buyer types the cédula de ciudadanía in the payment step, or the module takes it from a custom field your checkout already has. After the provider’s page the buyer comes back to the shop; if the confirmation is not there yet, the page says it is waiting and moves on by itself. A decline or a cancellation creates no order: the buyer sees why, nothing was taken, the cart is kept, and they can pay again.

What the admin gets

Each provider is a payment method of its own under Extensions → Payments, with the Account, Checkout and “Licence and Pro” tabs: environment, keys, the name and text for the buyer, minimum and maximum order total, geo zone, and the “Paid” and “Paid, needs a check” statuses. “Check connection” checks the keys, reads the Kueski Pay account limits, and for Addi gets the callback user and password from Addi and saves them; you can also type them by hand.

The order has a payment tab: attempts, provider ID, amount, refunds. If the amount, currency or cart does not match, or the order was paid twice, it gets “Paid, needs a check” with the reason in the history. In Pro the same tab makes refunds and asks the provider again; the payment watchdog finds payments of buyers who never came back to the shop and cancels Aplazo loans left unconfirmed for 48 hours. The journal shows the payments of all three methods.

How it works, step by step

1. You install the module and switch on the methods you need; on the Account tab you enter the keys the provider gave you.
2. Addi: “Check connection” gets the callback user and password from Addi, and the module sends the callback URL with every application. Aplazo gets the webhook URL with every loan.
3. The buyer picks the method, confirms the order and applies on the provider’s page.
4. Addi sends the result by callback, Aplazo by webhook, after which the module asks the API for the status itself; the Kueski Pay payment is read from the API. Only then, and only if the amount matches, the order gets the “Paid” status.
5. In Pro, refunds and asking the provider again are done from the payment tab of the order.

Under the hood

• Addi: a callback is accepted only with the right user and password, status APPROVED and an approved amount equal to the order.
• Aplazo: the webhook only triggers a status request to the API; a webhook token, if you agreed one with Aplazo, keeps other calls out.
• Kueski Pay: each attempt has its own idempotency key, and the payment is read from the API by its ID.
• A coupon discount is spread over the products, so the amount at the provider equals the order total.
• An open attempt is never closed blind: if an earlier attempt is paid later, the payment is still found and flagged for a check.
• Keys are stored encrypted; the debug log has no keys.

How to install

1. OpenCart 4.x and 3.x: Extensions → Installer, upload the archive for your version without renaming the file. OpenCart 2.3: copy the contents of the upload/ folder to the store root.
2. Extensions → Payments: install Addi, Kueski Pay or Aplazo and open it for editing.
3. On the Account tab choose the test environment, enter the keys, save and press “Check connection”.
4. Enable the method, set the statuses and limits on the Checkout tab, place a test order, then switch to the live environment with the live keys.
5. For Pro: paste the key or start the 7-day trial on the “Licence and Pro” tab. OpenCart 3 and 2.3: add the watchdog URL to your hosting cron every 15 minutes.