Add card

📘

After confirming the phone number or after user authorization, you will receive an access_token. You need to enter this access_token in the Token field.

📘

This endpoint is accessible for KYC_0 level and higher.

Upon adding a new card, it is automatically added to both PayIn and PayOut operations.

❗️

You cannot link a card that is already linked to another user

The body parameters

The API endpoint allows specifying only the recipient wallet address or phone number for conducting the transfer.

Request Sample: cURL

At the time of sending the request, the curl command should be as follows:

curl --request POST \
     --url https://api.vault.sandbox.testessential.net/v3/payin/card \
     --header 'accept: application/json' \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4NTU0ZDc0My05ZDExLTQ5YTEtYTMyMy03YmRmOGQ4NDdjMjEiLCJleHAiOjE3MDk3MjQ1NjQsImlhdCI6MTcwOTYzODE2NH0.deZXGfjS7oVprz2XoZseeYa7l8ti8aAJaELBeDDtglI' \
     --header 'content-type: application/json' \
     --data '
{
  "cardNumber": "Mara Sanchez Gonzalez",
  "cardHolder": "4012888888881881",
  "cardExpirationYear": 2026,
  "cardExpirationMonth": 3,
  "billingAddress": [
    {
      "address": "Kasteelstraat 79",
      "city": "Tielt",
      "countryCode": "BE",
      "zip": "8700",
      "state": "null"
    }
  ]
}
'

After entering the phone number and password into the respective fields, you need to click the Try It! button.

This action initiates the process of sending data to the server and receiving a response from the API using the provided credentials.

Response Example

Successful execution of the request indicates that the operation was successful.

OK

To obtain additional information about the RESPONSE, you need to click on the Headers button.

This will allow you to view the server response headers and gain a more detailed understanding of the data returned in response to your request.