Native Card Issuance Main Page



Synapse has the capability to issue cards on top of our accounts. They follow the functionality of those issued by traditional banks (e.g. ATM access, consumer protection), and give access to the interchange rails (e.g. providing the ability to push funds to the card/account).

Cards can be issued on top of our deposit (<<account_interestCheckingUS>>, <<account_depositUS>>,), FBO Deposit (SUBACCOUNT-US), and (<<account_loanUS>>) nodes. They can be virtual or physical and for businesses or individuals. We can issue debit BINs (cards that are used in the card networks' "debit card" payment network) and credit BINs (only available when the card is used for a LOAN-US node; makes use of the card networks' "credit card" payment network).

Node Type: Issued cards are a subnet of a node--they sit on top of an account or loan. Their account class (account_class) is CARD.

Native Issued Cards

We directly process transactions from our native issued cards. This provides benefits and functionalities that might not be provided by other card issuers including:

  • Sub-BIN per Platform: Each of our platforms receives a BIN range for their cards. Sub-BIN functionality lets merchants recognize cards by their type to allow for specific use cases (e.g. HSA-eligible spending, commuter benefits, etc.).

  • Per Transaction Decisioning: Platforms have the capability to allow or refuse a transaction in real-time based on MCCs (Merchant Category Codes) or other logic.

  • Instant Auth: With Instant Auth an account (normally with little to no balance) receives a pull transaction request from the card network, who notifies the platform, and who then (after some logical decisioning) funds the account for the requested amount of funds--at which point the pull transaction is executed.

Recommended Steps to Issue a Card

  1. Make sure your controls (what you are allowed to do in our system) allow for card issuance.

  2. Have a successfully created node that allows for the creation of card subnets. See Accounts or Lending Main Page for more information on how to do so.

  3. Make sure the user for whom the card is going to be issued for has SEND-AND-RECEIVE permissions and is not a match in one of our sanctions lists click here for our guide on how to check for this.

  4. Submit our Create Card call to create a card. Once created the card will have by default have a status of INACTIVE. The type of card BIN will be automatically assigned based on the nature of the underlying node.

  5. User our Allow Foreign Transactions to specify if foreign transactions are allowed (allow_foreign_transactions) or not, depending on what is best for your use case.

  6. If you're shipping physical cards use our Ship Card call to ship a physical card. We will send it to the address listed on the user's Base Doc (learn more about Base Docs here.

    • Standard shipping will typically take 8-10 business days.
Delivery Values
  • You can specify a delivery value (delivery), which incrementally increases in price (i.e. additional delivery fees will apply).




Standard shipping


Standard shipping with tracking


2-day shipping


Overnight shipping

  • Please note that expedite has been [DEPRECATED] and is replaced with delivery
  1. If you're shipping physical cards wait for confirmation from the user before activating the card.
  • For example, provide an Activate Card button in your app/on your website.
  1. Activate Card

Required KYC

In our system, cards sit on top of nodes. We capture user KYC at the node level, meaning that the KYC has been previously captured and is not directly captured at the card level. Please keep in mind that KYC requirements may vary depending on the specific use case.

Physical Card Art

Our physical cards are white-labeled and can be customized by the platform (although they must be approved by the card network). To learn more about the physical art process please contact your Account Manager or [email protected]

ATM Access

For Debit BINs only:

  • Green Dot Network Reload locations for cash deposits.
  • Allpoint Network card-less ATM withdrawal access.
  • Developing fee-less withdrawals from ATMs in the MoneyPass Network.

You can use our Find ATM Locations call to find ATMs (Allpoint & MoneyPass) near your location. When a user makes use of an out-of-network ATM, any applicable fees will be charged to the platform. This is done to give the platform the option to either cover the fee or pass it along to the user.


Below you can find links to API calls to perform various debit card actions, as well as to other supplementary resources.

APIs for Our Native Card Issuance Product

Return Codes & Statuses


Please refer to our General Legal page for more information.
If you are looking for our external card processing product please refer here

Updated 5 months ago

Native Card Issuance Main Page


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.