Step 3: convert a card

Now that we have an active virtual card, we can order a physical one. For this, you’ll need to provide a recipient address. In a production environment, we’ll send the card there. In a sandbox environment, no physical card is actually sent out.

In this example, we’ll be using the recipientAddress object. However, you can also create an address and provide an addressId in the request instead. For more information, see the API reference.

Optionally, you can specify the PIN for this card. If none is provided, we’ll automatically generate one for you.

The card you want to convert must be active when you make the request. This request will fail otherwise.

curl -i -X POST \
  'https://api-sandbox.equalsmoney.com/v2/cards/{cardId}/convert-to-physical?accountId={accountId}&personId={personId}' \
  -H 'Authorization: ApiKey {apiKey}' \ # Your API key
  -H 'Content-Type: application/json' \
  -d '{
    "pin": "{pin}",
    "recipientAddress": {
      "firstName": "{recipientFirstName}",
      "lastName": "{recipientLastName}",
      "address1": "{recipientAddressLine1}",
      "city": "{recipientCity}",
      "postalCode": "{recipientPostalCode}",
      "country": "{recipientCountry}"
    }
  }'

curl -i -X POST \
  'https://api.equalsmoney.com/v2/cards/{cardId}/convert-to-physical?accountId={accountId}&personId={personId}' \
  -H 'Authorization: ApiKey {apiKey}' \ # Your API key
  -H 'Content-Type: application/json' \
  -d '{
    "pin": "{pin}",
    "recipientAddress": { # We will send the card to this address in production
      "firstName": "{recipientFirstName}",
      "lastName": "{recipientLastName}",
      "address1": "{recipientAddressLine1}",
      "city": "{recipientCity}",
      "postalCode": "{recipientPostalCode}",
      "country": "{recipientCountry}"
    }
  }'

If your request is successful, you’ll receive a 201 response containing details about your new physical card.

{
  "forceChangePin": false,
  "id": "0302fbed-6078-4497-a580-61ad686eb228",
  "name": "Marketing",
  "personId": "cfd2431d-a682-4167-adfa-5975bc47aaf5",
  "accountId": "F12345",
  "state": "UNACTIVATED",
  "cardType": "PHYSICAL_MSR",
  "lastFour": "3315",
  "expiration": "0228",
  "cardProductToken": "4ac7a04a-da92-4785-add0-5168abf05683",
  "fulfillmentStatus": "ISSUED",
  "pinIsSet": true,
  "recipientAddress": {
    "address1": "123 Henry St",
    "city": "Porterville",
    "country": "US",
    "firstName": "Jane",
    "lastName": "Doe",
    "postalCode": "93257"
  },
  "cardPersonalization": {
    "text": {
      "nameLine1": {
        "value": "Jane Doe"
      },
      "nameLine2": {
        "value": "CUSTOMER"
      }
    }
  },
  "userTokenId": "5609caee-f89d-4e49-8d2e-6e4d8f8d0422",
  "cardOwnerType": "PEOPLE",
  "cardGroupId": "800065b2-4d12-42ac-940c-00cd930e3758",
  "cardProductId": "8bca2f68-7be0-4276-a125-4570ff54475a",
  "physicalCardState": "UNACTIVATED",
  "updatedAt": "2024-01-18T13:53:01.676Z",
  "createdAt": "2024-01-18T13:53:01.676Z",
  "meta": [
    {
      "id": "c808bb8f-2f5b-4d4e-bd3e-eeb59d42d1c5",
      "metaKey": "expirationTime",
      "metaValue": "2028-02-29T23:59:59Z",
      "cardId": "0302fbed-6078-4497-a580-61ad686eb228",
      "updatedAt": "2024-01-18T13:53:01.682Z",
      "createdAt": "2024-01-18T13:53:01.682Z"
    },
    {
      "id": "88b7c457-0e8f-4551-a555-01129a458ef2",
      "metaKey": "stateReason",
      "metaValue": "New card",
      "cardId": "0302fbed-6078-4497-a580-61ad686eb228",
      "updatedAt": "2024-01-18T13:53:01.688Z",
      "createdAt": "2024-01-18T13:53:01.688Z"
    }
  ]
}

Group placeholder

Group

Group

Convert a card

Step 3: convert a card

​Step 3: convert a card

Step 3: convert a card