This API reference is for the virtual cards documentation on Glade. Use this documentation to get details of request and responses.

Create a virtual card

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "create",
    "billing": {
        "address": "2 Crown Court Estate",
        "name": "Ade Musa Eze",
        "city": "Victoria Island",
        "state": "Lagos",
        "postal_code": "101241"
    },
    "amount": 2000,
    "currency": "NGN",
    "country": "NG"
}

Body Parameter

key	description
action (string)	Value should be set to `create` for creating virtual cards
billing (JSON)	Contains the billing address details of the user
address (string)	Address of user
city (string)	City of the user
state (string)	State of province to be associated with card
postal_code (string or integer)	Postal code of user
amount (integer)	Balance of virtual card when created. You need to have sufficient balance in your Glade wallet for this to be successful.
currency (string)	Currency of virtual card. This should either be `USD` OR `NGN`.
country (string)	Country code of user

Response

{
    "status": 200,
    "message": "Created Successfully",
    "card_data": {
        "reference": "Glade|GVC|1645012851|620ce773c946d791296011O",
        "balance": "2,000.00",
        "currency": "NGN",
        "cardpan": "5366130037820836",
        "maskedpan": "536613*******0836",
        "city": "Victoria Island",
        "state": "Lagos",
        "address": "2 Crown Court Estate",
        "postal_code": "101241",
        "cvv": "381",
        "expiration": "2025-02",
        "card_type": "mastercard",
        "name_on_card": "Ade Musa Eze",
        "card_owner": "customer",
        "status": "active"
    }
}

Funding a virtual card

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "fund",
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O",
    "amount": "1000"
}

Body Parameter

Key	Description
action (string)	Value should be set to `fund` for funding virtual cards
reference (string)	The `reference` gotten when a card is generated. This reference uniquely identifies the card.
amount (integer)	The amount to fund to the card. This amount would be in the card currency. This amount will be deducted from your Glade balance.

Response

{
    "status": 200,
    "message": "Virtual card funded successfully"
}

Withdraw from Card

When you withdraw from your virtual card, the amount withdrawn goes to your Glade wallet.

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "withdraw",
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O",
    "amount": "1100"
}

Body Parameter

Key	Description
action (string)	Value should be set to `withdraw` to withdraw from the virtual card
reference (string)	The `reference` gotten when a card is generated. This reference uniquely identifies the card.
amount (integer)	The amount to withdraw from the card. This amount would be in the card currency. This amount will be added to your Glade balance.

Response

{
    "status": 200,
    "message": "Withdrawal Successful"
}

View Card Transactions

You can fetch all the transactions on a card using the date range of the transactions.

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "transactions",
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O",
    "from_date": "2021-02-01",
    "to_date": "2022-02-27"
}

Body Parameter

Key	Description
action (string)	Value should be set to `transactions` to get the transactions of virtual cards
reference (string)	The `reference` gotten when a card is generated. This reference uniquely identifies the card.
from_date (DateTime)	The start date of the transactions to fetch
end_date (DateTime)	The end date of the transactions to fetch

Response

{
    "status": 200,
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O",
    "data": [
        {
            "id": 3166297,
            "amount": 25,
            "fee": 0,
            "narration": "Monthly Fee",
            "dateCreated": "2022-02-16T14:16:47.913Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Monthly Fee"
        },
        {
            "id": 3166296,
            "amount": 5300,
            "fee": 0,
            "narration": "Card Funding",
            "dateCreated": "2022-02-16T14:16:47.697Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding"
        },
        {
            "id": 3166295,
            "amount": 5300,
            "fee": 0,
            "narration": "Card Termination",
            "dateCreated": "2022-02-16T14:16:47.46Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Termination"
        },
        {
            "id": 3165947,
            "amount": 1100,
            "fee": 0,
            "narration": "Card Withdrawal",
            "dateCreated": "2022-02-16T13:19:56.543Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Withdrawal"
        },
        {
            "id": 3165931,
            "amount": 1000,
            "fee": 0,
            "narration": "Card Funding",
            "dateCreated": "2022-02-16T13:17:53.237Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding"
        },
        {
            "id": 3165907,
            "amount": 1000,
            "fee": 0,
            "narration": "Card Funding",
            "dateCreated": "2022-02-16T13:12:50.347Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding"
        },
        {
            "id": 3165896,
            "amount": 1000,
            "fee": 0,
            "narration": "Card Funding",
            "dateCreated": "2022-02-16T13:11:05.54Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding"
        },
        {
            "id": 3165452,
            "amount": 3400,
            "fee": 0,
            "narration": "Card Funding",
            "dateCreated": "2022-02-16T12:00:52.197Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding"
        },
        {
            "id": 3165451,
            "amount": 250,
            "fee": 0,
            "narration": "Card Issuance Fee",
            "dateCreated": "2022-02-16T12:00:51.303Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Issuance Fee"
        },
        {
            "id": 3165450,
            "amount": 3400,
            "fee": 0,
            "narration": "Card Funding Debit",
            "dateCreated": "2022-02-16T12:00:49.54Z",
            "status": "Successful",
            "currency": "NGN",
            "description": "Card Funding Debit"
        }
    ]
}

Block or Unblock a card

You can choose to block a card. Blocking the card will prevent transactions to be made with the card.

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "unblock",
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O"
}

Body Parameter

Key	Description
action (string)	Value should be set to `unblock` or `block` depending on the desired action
reference (string)	The `reference` gotten when a card is generated. This reference uniquely identifies the card.

Response

{
    "status": 200,
    "message": "Card unblocked successfully"
}

Terminate a card

When you terminate from your virtual card, the remaining balance on the card goes to your Glade wallet.

Endpoint

PUT https://api-sandbox.glade.ng/virtualcard

{
    "action": "terminate",
    "reference": "Glade|GVC|1645012851|620ce773c946d791296011O"
}

Body Parameter

Key	Description
action (string)	Value should be set to `terminate` to terminate a virtual cards
reference (string)	The `reference` gotten when a card is generated. This reference uniquely identifies the card.

Response

{
    "status": 200,
    "message": "Card terminated successfully"
}