Best Practices

externalCustomerId best practices

In POST Buy and POST Sell we ask you to send the field externalCustomerId. 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:

  1. The externalCustomerId should be unique per customer on your platform
  2. The same externalCustomerId should be passed for every Create Order request that is for the same customer
  3. The externalCustomerId should not be tied to anything which might at some stage become non-unique, such as wallet address.

Get Quotes call frequency

The Get Prices request returns our up to date pricing. The pricing endpoint should be called for every order to ensure you get the most accurate pricing for the quantity you require.

Using WebViews

If you are planning on using a WebView there are a few permissions and settings that will need to be enabled to use our services correctly.

  • WebView is able to access device local storage and initialize camera (for older iOS versions camera can be accessed only from Safari browser or WebView withSFSafariViewController)
  • Make sure that HTML5 video playback is allowed (we're using some instructions within tags): if video-instructions are not played, try using WebChromeClient to enable video playback
  • Autoplay in fullscreen mode is disabled and allowsInlineMediaPlayback is set as true for WebView

Camera Access

  • Feature-Policy header for your webpage/frame or any other container with SDK doesn't have any restrictions for initializing camera like value camera 'none'.
  • Permissions-Policy header doesn't restrict access to a camera and microphone (for some cases) and if allow is set check for "camera; microphone" values.

Note. Due to iOS restrictions, it is only possible to pass Sumsub KYC liveness check using the Safari browser.