Appmax for WooCommerce — Pix, card in instalments and boleto (Brazil)

Appmax for WooCommerce takes the shop payments through the Brazilian payment service Appmax: Pix with a QR code, credit card with instalments and boleto bancário. The buyer pays on a page of your shop, the order is confirmed when Appmax receives the money, and the admin sees the status, the amount and the actions right in the order.

What you need from Appmax. A merchant account at Appmax with its Client ID and Client Secret from the API screen of the panel (under Applications), and for the card the External ID of the store. The shop currency is the Brazilian real (BRL). Appmax charges its payment fees under your own plan.

What the buyer gets

At the checkout the buyer sees the Pix method. After placing the order a page opens with the QR code, the “Pix Copia e Cola” code with a copy button and a countdown to the end of the code validity. When the money arrives, the page moves to “Payment received” by itself, with no click and no reload. The same payment link is in “My account” and in the e-mail.

In Pro the checkout has two more methods. Card: an Appmax JS form with the card number, name, expiry, security code and a list of instalments (English or Brazilian Portuguese, by the shop language), instalments from the plans of your store at Appmax; the interest is added to the order as an “Instalment interest” fee, so the order total equals what the card is charged. Boleto: the digitable line, the due date, the buttons “Copy the line” and “Open the boleto (PDF)”, and the same data in the e-mail.

The payer CPF or CNPJ is checked by its check digits before anything goes to Appmax; the field is taken from a Brazilian checkout fields plugin when the shop has one, otherwise it is asked in the payment box. The phone with the DDD area code is asked only when the order does not have one. If a card is declined, the buyer sees a plain message, the cart stays, and another card or method can be tried.

What the admin gets

WooCommerce → Appmax: choose sandbox or production, paste the Client ID and the Client Secret and press “Check connection”. The secret is stored encrypted and is never shown back. The webhook address with a secret key is on the same screen: paste it in the Appmax panel under API → Webhooks.

Appmax signs nothing, so every notification is only a hint: the plugin reads the order back from Appmax and changes the status only then. An expired Pix cancels the order and returns the stock, a refusal for risk or an underpayment leaves the order unpaid with a note, and refunds and chargebacks are written to the order notes. The Pix validity can be set in minutes or left as set for your store at Appmax.

The order gets an Appmax box: the Appmax order number, the status, and the buttons “Check payment status” and (Pro) “Refund” and the subscription controls.

What Pro adds

Card with instalments. Appmax JS creates the token in the buyer browser. The number of payments is limited by your maximum and by the plan of your store at Appmax; the text on the card statement, up to 13 characters, is yours to set.

Boleto. The line and the PDF on the order page and in the e-mail; a boleto that Appmax cancels cancels the order too.

Refunds. From the order screen, full or partial (accumulating, never above what is left), for Pix and card. A boleto has no refund from the shop: Appmax does it from its own panel.

Subscriptions. A product gets a period and a number of charges; a paid order with such products becomes an Appmax subscription, and each new charge creates a paid renewal order in the shop. Pause, resume and cancel are in the order box.

Sync and sales recovery. Every hour the plugin reads back the orders that wait for payment, so a lost webhook does not leave an order on hold. Unpaid orders can be sent to Appmax sales recovery with the link to pay (at Appmax this feature is in beta).

Request log. The last 200 calls to Appmax: time, address, answer and duration; no card data, tokens or secrets.

How it works, step by step

1. Install and activate the plugin (WooCommerce must be active, the shop currency is BRL).
2. In the Appmax panel open API, press “Generate credentials”, choose the store and copy the Client ID and the Client Secret.
3. In WooCommerce → Appmax choose the environment, paste the credentials and press “Check connection”.
4. In the Appmax panel under API → Webhooks paste the webhook address from the settings and tick the order and payment events.
5. In WooCommerce → Settings → Payments enable “Pix (Appmax)” and place a test order.
6. In Pro turn on the card, boleto, subscriptions, sync and the log.

Under the hood

• Appmax API (OAuth2): customer, order, Pix, card and boleto payments, refunds, subscriptions; sandbox and production.
• A webhook at an address of your site with a long random key; the content of a call is not taken on trust, the status is set from the API answer.
• The payment page asks for the status at most every 30 seconds; repeated deliveries neither duplicate notes nor change the state twice.
• Appmax JS from scripts.appmax.com.br is loaded at the checkout: Appmax requires it to collect the buyer IP, and the card is tokenized with it.
• The Appmax quota is 100,000 requests a month per Client ID; the plugin makes no needless calls.
• The Client Secret is encrypted in the database and never printed in the interface.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate.
2. WooCommerce → Appmax: paste the Client ID and the Client Secret and press “Check connection”.
3. Copy the webhook address into the Appmax panel and enable “Pix (Appmax)” in the payment settings.
4. For Pro: paste a licence key or start the trial in the “Licence” section on the same page.