HomeGuidesChangelogDiscussions
Log In
Guides

Create Cards

Cards are issued to users by companies integrating with Juice's card issuing API.

Suggest Edits

Once a card is created, it can be used instantly through mobile wallets.

To set up a card, an integrator would use the Order Virtual Card API which returns a card_id. A card_id is peculiar to a card and it is used to get card details.

🚧

The Create Card request will not return all details about a card, like the card number and CVV. To get full details about a card, use the /cards/{id} end point.

An integrator that wants to issue a card to a user would need to provide the user_id for that particular user. The user_id is provided to an integrator when they register a user.

Sample Request

The integrator needs to specify what currency the card will operate on. Currently, we support only USD cards. Also, at this moment, we do not support single_use cards, therefore the single_use field should be set to false. Validity period for a card can either be 30 days or 365 days.

curl --request POST \
     --url https://api-sandbox.spendjuice.com/cards/create-virtual-card \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
     "design_type": "Aurora",
     "single_use": "false",
     "source": "business",
     "business_id": "3d6cde2e-13af-4807-97ff-bbd35fc4dc1b",
     "currency": "USD",
     "user_id": "3d6c9e2e-1caf-4807-97ff-bbd35fc4dc1b",
     "validity": 30
}
'

📘

Now Available: Physical cards

Juice enables you to issue customisable physical cards individually or in bulk to your users.

Getting User Information

An integrator can view all users associated with them by a simple API call. All user informations are listed when the /card-integrators/card-users endpoint is called. This instance is represented below. 

curl --request GET \
     --url 'https://api-sandbox.spendjuice.com/card-integrators/card-users?limit=15&page=1' \
     --header 'Accept: application/json'

{
    "data": [
        {
            "address": {
                "city": "ibadan",
                "country": "NGA",
                "line1": "eleyele",
                "line2": null,
                "state": null,
                "zip_code": "101111"
            },
            "archived": false,
            "card_integrator_id": "18b7c9b6-cf4f-486a-a41e-6bcb200eb22f",
            "email": null,
            "first_name": null,
            "id": "35dbb9c6-eb4c-4dc5-8c9d-2923b82200b1",
            "id_number": "00000000000",
            "id_type": null,
            "last_name": null,
            "phone_number": null,
            "verified": true
        },
        {
            "address": {
                "city": "Maitama",
                "country": "NGA",
                "line1": "Shehu Shagaris",
                "line2": null,
                "state": null,
                "zip_code": "972001"
            },
            "archived": false,
            "card_integrator_id": "18b7c9b6-cf4f-486a-a41e-6bcb200eb22f",
            "email": null,
            "first_name": null,
            "id": "c2d31f36-05f5-4957-8952-82793f7bd372",
            "id_number": "00000000000",
            "id_type": null,
            "last_name": null,
            "phone_number": null,
            "verified": true
        }
    ],
    "page": 1,
    "total": 2,
    "total_pages": 1
}

Updated over 2 years ago