Payment Brokers
Payment Brokers
Payment Brokers connect CifraHQ to online payment gateways like Stripe or PayPal, turning every emailed invoice into a self-service payment link. When your customer clicks Pay Now, they're taken to a secure checkout — and once they complete payment, CifraHQ records the transaction automatically with no manual entry on your end.
Where to find it
Go to Master Data > Sales > Payment Brokers.
Payment Brokers list, third-party processors that route customer payments.
How to configure a Payment Broker
- Click New.
- Enter a Code and Description (e.g.,
STRIPE,Stripe Payments). - Select the Broker Type (e.g., Stripe, Yappy).
- Enter the API Key provided by your payment gateway account.
- Set the Financial Institution — the bank account in CifraHQ where received funds are deposited.
- Set the Payment Method — the method recorded on auto-created Invoice Payments (e.g.,
CARD). - Optionally link a Print Report — the invoice layout included in the payment email.
- Set a Return URL — where Customers land after completing payment (typically a thank-you page on your site).
- Save.
Yappy as a Payment Broker
Select Yappy as the Broker Type to let Customers pay an invoice with Yappy (Boton de Pago). A few extra fields appear:
| Field | What to enter |
|---|---|
| API Key | The Yappy Boton de Pago clave secreta. This is a different secret from the Commerce Integration credentials used for reconciliation — it comes from the Boton de Pago section of Yappy Comercial. |
| Yappy Merchant ID | Your id de comercio from Yappy Comercial. |
| Yappy URL Domain | The domain registered for the button in Yappy Comercial. It must match exactly (for example barrdega.CifraHQ.cloud). |
| Environment | prod for live payments. Use the production environment whenever your credentials come from the live Yappy Comercial portal. |
Keep at most one Yappy broker per company. Yappy is offered only on USD Invoices, not on Sales Orders.
Setting the default
Toggle the Default switch on the broker you want offered first. With more than one broker available, the default simply sorts ahead of the others on the customer's checkout page.
Assigning brokers to a customer
On a customer record, turn on Enable credit card billing and use the Payment broker (optional) field:
- Leave it blank to offer that customer every configured broker. When they open a payment link with more than one option available, they choose how to pay (for example "Pay with Yappy" or "Pay with credit card") on a simple checkout page.
- Select a single broker to restrict that customer to only that one.
This means a customer is no longer locked to a single payment method — Yappy and a card gateway can both be offered on the same invoice, and the customer picks at pay time.
Tips
- The API Key is stored encrypted and is never displayed in plain text after saving — keep your gateway credentials safe in the initial Setup step.
- Only one broker can be the default at a time; the default only affects ordering, not which brokers are available.
- Multiple brokers can coexist — useful when you want to offer Customers a choice of how to pay.
Related: Yappy Payments · Payment Methods · Customers · Invoice Payments
Was this page helpful?