Virtual Cards

Create card

It’s pretty simple to create a virtual card. Check the example in the box below for details.

POST https://vcard-api.paycertify.com/api/vcards

Parameter Type Presence Description Example
type string required The vcard type single_use
provider_id uuid optional Provider ID 89bfc6e4-931a-42ff-b8d6-945e28b5dc80
first_name string required Person’s name John
last_name string required Person’s last name Doe
street_address_1 string required Address 1 17770 Daves Ave
street_address_2 string present Address 2 17771 Daves Ave
zip string required Zip code 91343
city string required City name Los Gatos
state string required Alpha-2 state code CA
country string required Alpha-2 country code US
email string required Person’s e-mail [email protected]
phone string required Person’s phone 5555551234
amount float required Card amount 200.50
Field Type Description Example
id uuid The vcard ID 9d616a21-e85f-423a-90e2-e2dd52d7f2ff
type string Card type single_use
provider_id uuid Provider ID 89bfc6e4-931a-42ff-b8d6-945e28b5dc80
merchant_id uuid Merchant ID 98e2c511-bf77-4893-a16c-23d593a530ad
first_name string Person’s name John
last_name string Person’s last name Doe
street_address_1 string Address 1 17770 Daves Ave
street_address_2 string Address 2 17771 Daves Ave
zip string Zip code 91343
city string City name Los Gatos
state string Alpha-2 state code CA
country string Alpha-2 country code US
email string Person’s e-mail [email protected]
phone string Person’s phone 5555551234
external_id uuid External ID befb57e1-e042-335a-8516-73be1423bada
card_number string Vcard number 5326137298354870
card_expiry_month string Expiration month 08
card_expiry_year string Expiration year 2020
amount float Card amount 200.50
curl -X POST \
  https://vcard-api.paycertify.com/api/vcards \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "vcard" : {
        "type": "single_use",
        "provider_id": "89bfc6e4-931a-42ff-b8d6-945e28b5dc80",
        "first_name" : "John",
        "last_name" : "Doe",
        "street_address_1" : "17770 Daves Ave",
        "street_address_2" : "17771 Daves Ave",
        "zip" : "91343",
        "city" : "Los Gatos",
        "state" : "CA",
        "country" : "US",
        "email" : "[email protected]",
        "phone" : "5555551234",
        "amount": 200.50
    }
}'

Responds with:

{
    "vcard": {
        "id": "2a94edf5-fb2b-45f1-bce8-eb2545607d8b",
        "type": "single_use",
        "provider_id": "89bfc6e4-931a-42ff-b8d6-945e28b5dc80",
        "merchant_id": "98e2c511-bf77-4893-a16c-23d593a530ad",
        "first_name": "John",
        "last_name": "Doe",
        "street_address_1": "17770 Daves Ave",
        "street_address_2": "17771 Daves Ave",
        "zip": "91343",
        "city": "Los Gatos",
        "state": "CA",
        "country": "US",
        "email": "[email protected]",
        "phone": "5555551234",
        "external_id": "d7a3b257-4075-3f0f-89a3-55924faf9910",
        "card_number": "2674092984630791",
        "card_expiry_month": "06",
        "card_expiry_year": "2019",
        "amount": 200.5
    }
}