Six common questions when integrating this product.
Integration FAQ
What if a Quote Expires While the User Is Still Completing the Form?
Show a countdown, automatically obtain a new quote at expiry, and highlight the new figures. Requiring manual refresh leaves the user making decisions based on stale numbers.
Order Creation Returned 504. Should I Retry or Query?
Retry with the same idempotency key. We may already have created the order; reusing the key returns it. A new key means a second real payment.
Why Does Order Creation Report Invalid Fields After the Payee Was Created?
We validate formats when saving the payee; upstream payee registration occurs at dispatch, after funds have been frozen. Fetch the corridor's field schema rather than hardcoding a form from an example.
Will an Order Stuck in action_required Eventually Be Refunded Automatically?
No. Funds remain locked until the member acts or you explicitly cancel. See Supplementary Documents and Reconfirmation.
I Received a Status Not Listed in the Documentation.
Treat it as unknown and raise an alert. Do not fall back to Processing. Notify us as well: we commit to listing new enum values in the changelog before introducing them. An unlisted value means we missed that step.
Does What You Charge Us Depend on What We Charge Members?
No. We charge you a wholesale price, shown under Billing in the merchant portal. You configure your member pricing in the portal. The difference is your gross profit.