How to Accept Payments With Boleto in Your Online Store Using OzSpeed hPanel

Boleto Bancário (Boleto) is a popular payment method in Brazil, allowing customers to generate and pay invoices through banks, ATMs, or online banking. Integrating Boleto into your online store is an excellent way to cater to Brazilian customers.

Here’s a step-by-step guide to enable and configure Boleto using OzSpeed hPanel:

---

Step 1: Set Up a Boleto Payment Account #

1. Partner with a payment gateway that supports Boleto transactions (e.g., Stripe, PagSeguro, or Mercado Pago).
2. Sign up for an account and provide the required business documentation:
   • Business name, tax ID (CNPJ or CPF), and contact details.
   • Banking details for payment settlements.
3. Once approved, you will receive API credentials to integrate Boleto.

---

Step 2: Log in to OzSpeed hPanel #

1. Visit OzSpeed hPanel.
2. Enter your credentials and log in.
3. Navigate to Online Store > Payment Settings.

---

Step 3: Enable Boleto #

1. In the Payment Methods section, click Add Payment Method.
2. Select Boleto from the list of available options.
3. Enter the necessary credentials:
   • Merchant ID: Provided by your payment gateway.
   • API Key/Secret: Credentials for secure integration.

---

Step 4: Configure Payment Settings #

1. Define the Payment Regions:
   • Set Boleto to be available for customers in Brazil.
2. Enable Currency Support:
   • Boleto transactions are typically processed in BRL (Brazilian Real).
3. Add a Payment Deadline:
   • Specify how many days customers have to pay their Boleto invoice (e.g., 3 or 7 days).
4. Save the changes.

---

Step 5: Customize Boleto Checkout Process #

1. In Checkout Settings, ensure the following fields are enabled:
   • CPF/CNPJ: Required for issuing Boletos in Brazil.
   • Email Address: For sending the Boleto invoice and payment confirmation.
2. Add clear instructions at checkout on how customers can pay using Boleto.

---

Step 6: Test the Boleto Integration #

1. Enable Test Mode in your payment gateway.
2. Simulate a purchase on your storefront:
   • Add a product to the cart and proceed to checkout.
   • Select Boleto as the payment method.
   • Generate a test Boleto invoice and verify that it displays correctly.
3. Confirm that the test payment status updates in the Orders section of hPanel.

---

Step 7: Enable Live Transactions #

1. Disable Test Mode in both hPanel and your payment gateway account.
2. Save the changes to start accepting real Boleto payments.

---

Step 8: Monitor Boleto Payments #

1. Log in to your payment gateway dashboard to:
   • View pending and completed payments.
   • Reconcile settlements to your bank account.
2. Update the order status in hPanel as payments are confirmed.

---

Troubleshooting Tips #

1. Boleto Not Available at Checkout:
   • Verify that Boleto is enabled in Payment Settings.
   • Ensure the customer’s region is set to Brazil.
2. Incorrect or Missing Fields:
   • Ensure CPF/CNPJ and email fields are correctly configured in checkout settings.
   • Confirm that your payment gateway supports the required data fields.
3. Delayed Payment Confirmations:
   • Note that Boleto payments may take 1-3 business days to confirm.
   • Inform customers of the expected delay during checkout.

---

Additional Tips: #

• Highlight Availability: Display the Boleto logo on your checkout page to inform customers about the payment option.
• Localized Experience: Offer your website in Portuguese and display prices in BRL for Brazilian customers.
• Set Reminders: Send email reminders to customers about pending Boleto payments to encourage timely processing.