Introduction

Create virtual card

Creates a new virtual card. On the creation of the card, you will need to choose the way that each transaction made by the client will be approved.

WEBHOOK approval method, means that on every purchase that the client will do with the card, a notification will be sent to the configured notification address with the transaction information on it. A response to it ll be required to approve the transaction.

TOPUP approval method is used to approve transactions based on the balance of a crypto wallet associated with the virtual card. Each virtual card has a unique, dedicated wallet tied to it. When a transaction is attempted, the following rules apply:

Sufficient Balance: The transaction will only be approved if the associated wallet contains the required amount of cryptocurrency to cover the cost.
Limit Compliance: The transaction must also respect any pre-defined limits for the card (such as daily, weekly, or monthly transaction limits).

Required access level: Operational Access (Level 2)

Header Parameters

Postman-Tokenstring Required

Identifier used to authenticate a user for the use of the CryptoMate APIs.

Body Parameters

card_holder_namestring Required

Name of the person that will use the virtual card. It will be the name that will appear on it.

emailstring Required

E-mail associated to the card holder. This input will be used for validating the card for Google Pay and Apple Pay

phone_country_codestring Required

Coutry code associated to the phone number of the card holder. This input will be used for validating the card for Google Pay and Apple Pay

phonestring Required

Phone number of the card holder. This input will be used for validating the card for Google Pay and Apple Pay

approval_methodstring Required

Approval method for each transaction that the card holder make. Possible values WEBHOOK | TOPUP

daily_limitnumber

This limit specifies the maximum amount of money that can be spent with the virtual card in a single day. If no value is specified, there will be no limit for daily spending.

weekly_limitnumber

This limit specifies the maximum amount of money that can be spent with the virtual card over the course of a week. If no value is specified, there will be no limit for weekly spending

monthly_limitnumber

This limit specifies the maximum amount of money that can be spent with the virutal card over the course of a calendar month. If no value is specified, there will be no limit for monthly spending

Response

200

Object

Response Attributes

idstring

Unique ID of the created card

card_holder_namestring

Name that will appear on the virtual card

typestring

Type of the card created. Possible values VIRTUAL or PHYSICAL

last4string

Last 4 number of the created virtual card

statusstring

Status of the created card. Possible values ACTIVE, DELETED, EXPIRED, FROZEN, INACTIVE or BLOCKED

daily_limitnumber

Maximum amount of money that can be spent with the virtual card in a single day

weekly_limitnumber

Maximum amount of money that can be spent with the virtual card over the course of a week

monthly_limitnumber

Maximum amount of money that can be spent with the virtual card over the course of a calendar month

Sections

Create virtual card

Header Parameters

Body Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Sections

Create virtual card

Header Parameters

Body Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Ask an AI

Code with AI