Synapse Developer Hub

Welcome to the Synapse Developer Hub. Here you will find comprehensive guides and documentation to help you start working with the Synapse API as quickly as possible. If you need any assistance, we are always here to help!

VIRTUAL CARDS VS PHYSICAL CARDS

To issue a virtual card, simply create the card and remember to update the card preferences before spending. These preferences include pos_withdrawal_limit, atm_withdrawal_limit, and allow_foreign_transactions.

To ship a physical card to the user, make our Ship Debit Card API call. This will be a physical copy of your virtual card - same card number, expiration and CVV.

PCI Considerations

Please DO NOT store card numbers. Please also review the following before displaying card information.

Web Interfaces:If you plan to have a web version of your app, we do not recommend displaying card_number, cvc and exp date unless you are PCI compliant. This is because you will have to route this through your server, even if you are not storing card information. We recommend using our UI as a Service component for this use case, so you can redirect users there when viewing card details.

App Interfaces:For applications, you can do the GET API call in the app itself. That way you are in full control of the UI without transmitting card data through your servers. Here is what we recommend:

OAuth the user on your server, but with only scope "NODE|GET"

Send this oauth_key to the user’s app

Do full_dehydrate=yes from the app

Negative Balance Reconciliation

We reconcile negative balances when accounts have been negative for 30 days with no successful activity. These reconciliations occur throughout the month, and funds will be debited from your reserve account to reconcile these balances. After an account has been reconciled, the user will be locked. If the user is locked, but they still wish to repay their negative balance, please send us the User ID to unlock the user.

For example:If a user has a negative balance of -$500 and they pay +$400 toward that negative balance before the 30 day period is up, we will reset the 30 day countdown. If another 30 days passes and there is no successful activity, we will reconcile the remaining negative balance of -$100 from your reserve funds.

We recommend setting up webhooks to monitor your reserve account balance. This will help you automatically fund your reserve when it falls below your required minimum balance.