API Reference

Create Card

post
https://v1/v1/cards

Before you begin: Ensure a card product has been configured for your tenant. See Create Card Product for setup instructions.

Use this API to issue and instantly activate a new card for a client — whether that's a debit card tied to a savings account or a credit card linked to a credit account. Once created, the card is automatically activated and ready for immediate use.

How it works

Mbanq sets up the card product on your behalf. To create a card, simply supply the cardProductId that corresponds to the type of card you want to issue.

Card types

  • Debit Card — Link the card to an existing savings account, or create a new one first using Create Savings Account.
  • Credit Card — Link the card to an existing credit account, or create a new one first using Create Credit Account.

You can also pass a userId to associate the card with a specific user within the client's account.

What to expect

A successful response confirms that the card has been created and activated. No additional activation step is required.

For a full overview of card capabilities, see the Card Features guide.

Webhooks

The following webhook events are triggered once the card is ordered and activated:

EventWebhook Reference
Order CardOrder Card
Activate CardActivate Card
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The request body must match one of the following requests depending on the card type:

How to Use

  • Provide either savingsAccountId (for an existing account) or savingsProductId (to create a new account for the client).
  • productId is required and refers to the card product configuration.
  • clientId is required if creating a new account.
  • Optionally, associate the card with a specific user using userId.

Example Scenarios

  • Link to existing account: Provide savingsAccountId, productId, and optionally userId.
  • Create new account: Provide savingsProductId, clientId, and productId.
integer
required
Defaults to 1

The ID of the card product to use. This must be pre-configured.
Pattern: ^\d+$
Example: 1

integer
required
Defaults to 18

The ID of the existing savings account to link the debit card.
Conditional Requirement: savingsProductId and clientId are not required if savingsAccountId is provided.
Pattern: ^\d+$
Example: 18

integer

The ID of the user within the client account to associate the card.
Pattern: ^\d+$
Example: 7

integer

The ID of the client. Required if creating a new account with savingsProductId.
Pattern: ^\d+$
Example: 111

Headers
string
required
Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?