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!

Assign this value only in case of making a transaction to or from CRYPTO-US. Acceptable values are BTC and ETH

extra.same_day :

booleanfalse

Set this to true if you wish to settle the ACH on same day. Please note this would only work, if same day ACH has been enabled for your platform

extra.supp_id :

string

ID supplied to the transaction. Allows clients to track transactions based on specific events.

extra.group_id :

string

Group ID supplied to the transaction. Allows clients to track transactions based on specific events.

extra.note :

string

Memo tagged with the transaction

extra.process_on :

integer0

When the transaction should be processed. The value is the delta value. Which means when 1 is supplied it means that the transaction will be processed tomorrow.

extra.other.attachments :

array of strings

Array of padded base64 of attachments

fees[fee ]:

double

Fee associated with the transaction

fees[note ]:

string

Reason for the fee

fees[to].id :

string

Node ID where the fee would be credited when the transaction settled. Fee node has to be DEPOSIT-US type always

Transactions with CRYPTO-US Accounts

SynapseFI's Crypto wallet acts as a portfolio of cryptocurrencies. To fund this portfolio you can buy or sell crypto assets by supplying extra.asset value in the transaction JSON when you create the transaction.

If you are creating a transaction from SUBACCOUNT-US to CRYPTO-US, you will need to supply extra.asset as BTC or ETH, so the transaction amount will go towards making a cryptocurrency purchase for the user portfolio.

If you are creating a transaction from CRYPTO-US to SUBACCOUNT-US and you supply extra.asset as BTC of ETH, then the transaction amount will go towards selling the cryptocurrency out of the user portfolio.

If no extra.asset is supplied, the transaction would fail and the transaction status will be RETURNED.

All buy and sell happens in USD. So before creating a transaction, its advisable to display the exchange rate and price to users before executing the transaction. This can be done by calling the crypto quotes API.

Please refer to the Crypto Wallet product page for more details.

Transactions with SAME DAY ACH

To be able to settle an ACH payment on the same day, you need to be able to supply extra.same_day as true.

Please note this feature only works if Same Day ACH has been enabled for your platform. All Same Day ACH transactions need to be submitted before 9 am PST to meet the cut-off time for same day transactions. Any transactions sent afterward will have an effective date of the next day.

Below is an example transaction for your convenience. Please refer to the appropriate payment product page for relevant details, including return/chargeback timelines.with them: