Virtual Cards

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"
}