In Create Order we ask you to send the field
account_reference. Banxa uses this to find your customer in our platform. This ensures that we do not ask these customers for information which has previously been collected, such as KYC data or personal information.
The best practices to follow here are:
account_referenceshould be unique per customer on your platform
- The same
account_referenceshould be passed for every Create Order request that is for the same customer
account_referenceshould not be tied to anything which might at some stage become non-unique, such as wallet address.
- If you cannot guarantee uniqueness of the
account_referencethen we have an alternative solution we can work with you on but it is not preferred due to certain limitations. Please get in touch with your account manager if you would like to discuss this option.
payment_method_id which is returned from the Get Payment Methods request and used in the Create Order request, will normally not change but on occasion these can change due to re-structuring of our payments or to add new payments or remove unavailable ones. For this reason you should use the Get Payment Methods request to get all available payments to use for the selection of payment method on your platform. The response could be cached and refreshed periodically to ensure any changes are reflected on your side.
In the response to Get Payment Methods we return a
supported_agents field which indicates which browsers and operating systems a payment is available in. In order to avoid customer confusion, Apple Pay should not be enabled if the browser or operating system they are using does not match what is returned here, which is basically any Apple OS and Safari.
The Get Prices request returns our up to date pricing. This data is only refreshed every 5 mins, so our preference is that you don't call this request more than once every minute at the most
Updated over 1 year ago