Integration Checklist

This  document  includes  a  checklist  to  assist  our  new  partners  with  the  Simplex
integration,  development  and  testing.  This  checklist  aims  to  help  the  partners
understand the integration workflow and specific test worthy use-cases.
Note: This document does not replace the need for a thorough test plan by the partner
which should cover all facets of the integration. It simply identifies certain topics the
partner should verify prior to going live.
IP/s to whitelist in production: 1-3 IPs are available per partner
Please specify the full domain name\s on which you will run the checkout page (in case the “widget” solution is chosen
Please specify the subdomain URL where the Simplex’s Quote form (IFrame) will be implemented on
Please indicate the domain on which the end-users will be referred from
The CSS code snippet of the Quote form (IFrame), so we will be able to reflect it accordingly in the production environment
The POC who received the encrypted production API_KEY:
The POC who will perform payments test in production:
The POC who received the production JWT secret
Your public crypto addresses to which we will send your fee. supported file formats: xlx,xlsx,txt,csv
Link to a wallet addresses site that can be used by the end-user to create a new wallet address in case they don’t already have one set up already (e.g. electrum.org/#download ). We will implement only one link in the buy page regardless of the number of supported cryptocurrencies. Therefore, we recommend sending a link that will allow creating multiple cryptocurrencies wallet addresses
* Multi Select
Please provide the URL which will redirect the end-user after the payment has been successfully completed
Please provide the URL which will redirect the end-user after the payment has failed
Please provide a general return URL for both cases
Will be displayed on the Simplex checkout page on the upper left corner.
The logo should be bright to match the dark header background
Please upload SVG file only
Action Items

Please go over the following list  and make sure you complete all the necessary action items and related to all suggestions:


Topic

Description

Supported fiat currencies and cryptocurrencies

Please check which fiat and cryptocurrencies are supported in your app - Simplex supports the currencies found in this link: https://integrations.simplex.com/supported_currencies

Events Endpoint

Please make sure to call the Events endpoint to get updates on payments status changes. Payment status should not be changed without a specific notification from the /events API.

Events Deletion

Don’t forget to delete the events after handling. (Status should not be changed without a specific notification from the /events API)

Reflection of pending payments in your app

Do you show a list of pending payments in your app until Simplex approves/declines a payment? We recommend doing this as it will help the user to clearly understand the status of their payment.

 

Security Restrictions

Do you have any specific restrictions in your App? As an example, security reason, like making the bitcoin purchased available for the user only after some period of time? If so, a clear message explaining that should appear to the user during the payment process.

Simplex response to the partner/data call

Are you making sure to review partner/data calls in case of errors? Simplex will respond with an error in case of a validation error, which could cause the entire payment to fail if not handled.

Min and Max amount validations

Have you validated the minimum total amount per payment of $50 and a maximum payment of $20,000 (**including fees**)?

Make sure to include extreme cases such as 0 (zero) values.

End-user IP

Please check that you are sending the client IP and NOT the reverse proxy (e.g. Incapsula/CloudFlare/other CDN)?

Live test payment

Have you performed a live transaction test?
We advise to review the following items, as well:

Topic

Description

clear logs and automatic alerts

Do you have clear logs and automatic alerts on your monitoring system for failures on API calls to Simplex?

Min and Max total amount alert validation per payment

If the amount entered by the user is below minimum/above maximum, we recommend still displaying the “Pay with CC” option with a hint to explain what they should change to make it work.

Submit Errors

Please ensure that you are displaying user error messages correctly.

Payment ID

We recommend that you show the user the Payment ID (which is also sent to Simplex’s API) in the email? The client will use this ID in any communication to the Simplex support team.
Important Notes:
  • The monthly cap per user is $50,000 (Including fees)
  • The Partner API calls to Simplex must deal with errors that might be returned from Simplex’s API.
  • In the event of errors from the events endpoint, please make sure to communicate the error to Simplex with a clearly understandable “name” and description of the event. 

Contact Information