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