Troubleshooting
Common Issues and Solutions
Issue: Plata by Mono is not displayed as a payment method on the website
Possible Causes:
- The Plata by Mono provider is in the Disabled state.
- The API Token (X-Token) is not filled in on the Credentials tab.
- The provider is not published (is_published = True).
Solution:
- Go to Accounting (Invoicing) → Configuration → Payment Providers or Sales → Configuration → Payment Providers.
- Open the Plata by Mono provider.
- On the Credentials tab, make sure the API Token (X-Token) field is filled in.
- Click Enabled (for production) or Test Mode (for testing) so that the provider status changes to Published.
Issue: The provider is not configured for a newly created company
Cause: Plata by Mono settings are company specific. For each new company created after the module is installed, the provider must be configured separately.
Solution:
- Switch to the relevant company.
- Open the Plata by Mono provider of that company and configure it (token, journal) as described in Configuration.
Issue: A refund cannot be completed or the amount is rejected
Possible Causes:
- The entered amount is greater than the Maximum Refund Allowed — Odoo will not allow this.
- The Mono API returned an error.
Solution:
- Enter an amount that does not exceed the Maximum Refund Allowed.
- If the Mono API returns an error, the system shows the reason and the original Payment status remains unchanged — review the reason and retry.
Issue: The Invoice and Payment stay in the In Payment / In Process status (Enterprise)
Cause: With the Accounting module installed, the operation is completed only after the bank statement is reconciled.
Solution:
- Post the bank statement and reconcile it with this payment.
- Use the unique Plata by Mono invoiceId to match the bank statement line with the payment — it is stored in the Payment Reference / Provider Reference field of the Payment Transaction and in the Memo field of the linked Payment.
- After reconciliation, the Invoice and Payment status changes to Paid.