Cards

Create and manage Card programs

The Card API allows you to create and manage your VeendHQ Cards.

Create a Card Program

Create a Card Program

POST {{BASE_URL}}/cardprograms?accountId={{ACCOUNT_ID}}

Request Body

NameTypeDescription

numberOfCards*

100

The number of cards to create

programName*

FGN28

A unique name for the Card program

location

Lagos

Update a Card Program

Update a card program

PATCH {{BASE_URL}}/cardprograms/{{CARD_ID}}?accountId={{ACCOUNT_ID}}

Request Body

NameTypeDescription

numberOfCards*

String

Number of cards for the card program

location*

String

Location

Generate Cards

Generate Card files

POST {{BASE_URL}}/cardprograms/generate-card-files?accountId={{ACCOUNT_ID}}

Query Parameters

NameTypeDescription

accountId*

String

Request Body

NameTypeDescription

programName*

String

Card Program Name

Get All Card Programs

Get all card programs

GET {{BASE_URL}}/cardfiles/{{CARD_ID}}?accountId={{ACCOUNT_ID}}

Query Parameters

NameTypeDescription

accountId*

_id

populate

cardOwnerId,

Get All Card Request

Get all card request

GET {{BASE_URL}}/cardfiles?accountId={{ACCOUNT_ID}}

Fund a Card

Fund a Card

POST {{BASE_URL}}/cardfiles/{{CARD_ID}}/fund?accountId={{ACCOUNT_ID}}

Request Body

NameTypeDescription

amount*

2000

Amount

Withdraw Fund

Withdraw fund from a Card to account.

POST {{BASE_URL}}/cardfiles/{{CARD_ID}}/withdraw-fund?accountId={{ACCOUNT_ID}}

Set Card Limit

Set single transaction limit, daily, weekly and/or monthly limit

GET {{BASE_URL}}/cardfiles/{{CARD_ID}}/setlimit?accountId={{ACCOUNT_ID}}

Query Parameters

NameTypeDescription

accountId*

String

dailyLimit

20000

Maximum amount daily transactions

monthlyLimit

1000000

singleTransaction

5000

Block a Card

Block a Card

GET {{BASE_URL}}/cardfiles/{{CARD_ID}}/blockcard?accountId={{a}}

Block a Card

Query Parameters

NameTypeDescription

accountId*

{{ACCOUNT_ID}}

Card Transactions

Get all transactions for a particular Card.

GET {{BASE_URL}}/cardfiles/{{CARD_ID}}/transactions?accountId={{ACCOUNT_ID}}

{
    "status": "success",
    "data": {
        "transactions": [
            {
                "frontendStatus": "successful",
                "veendFee": 0,
                "otherFees": 200,
                "purchaseReference": "NGN_INTERNAL_DEPOSIT_1673527567316",
                "cost": 200,
                "merchantFee": 0,
                "customerFee": 0,
                "cashback": 0,
                "referralCommission": 0,
                "totalCost": 200,
                "description": "NGN200 - NGN Internal - Deposit - Veend Jim01 - NGN_INTERNAL_DEPOSIT_1673527567316",
                "currency": "NGN",
                "status": "completed",
                "paid": true,
                "delivered": false,
                "settled": true,
                "canRefund": false,
                "product": "63bff3c868f7910013964929",
                "productsDetails": {
                    "owner": "63bff39246f4a20013a783b7",
                    "amount": 200,
                    "currency": "NGN",
                    "description": "Card Funding",
                    "purchaseReference": "NGN_INTERNAL_DEPOSIT_1673527567316"
                },
                "ipAddress": "::ffff:192.168.32.221",
                "account": "63bff39246f4a20013a783b7",
                "deliveryLog": {
                    "error": "service provider currently not supported",
                    "retryReference": "retry0-438",
                    "paymentReference": 438
                },
                "settlementLog": {
                    "adminSettlement": {},
                    "productOwnerSettlement": {}
                },
                "refundLog": null,
                "validationDetails": null,
                "batch": null,
                "payment": 438,
                "feeCalculationData": {
                    "__v": 0,
                    "_id": "63bff3c868f7910013964929",
                    "fee": 0,
                    "code": "5NXKtgJiks",
                    "name": "NGN Internal - Deposit - Veend Jim01",
                    "tags": [
                        "percentage",
                        "flat",
                        "percentage",
                        "percentage",
                        "oneTime",
                        "none",
                        "default",
                        "default",
                        "5NXKtgJiks",
                        "NGN",
                        "Internal",
                        "-",
                        "Deposit",
                        "-",
                        "Veend",
                        "Jim01",
                        "NGN_INTERNAL_DEPOSIT_PROVIDER",
                        "63bff3c868f791001396490e",
                        "NGN",
                        "5e5d34448172fc054a3b8979",
                        "5e5d34448172fc054a3b8979",
                        "2023-01-12T11:49:28.846Z"
                    ],
                    "type": "oneTime",
                    "model": "Products",
                    "owner": "5e5d34448172fc054a3b8979",
                    "amount": 0,
                    "isSync": false,
                    "status": "default",
                    "account": "63bff3c868f791001396490e",
                    "dueDate": "2023-01-12T11:49:28.846Z",
                    "enabled": true,
                    "feeType": "flat",
                    "cashback": 0,
                    "category": "default",
                    "currency": "NGN",
                    "featured": false,
                    "runCount": 0,
                    "canRefund": false,
                    "createdAt": "2023-01-12T11:49:28.846Z",
                    "createdBy": "5e5d34448172fc054a3b8979",
                    "updatedAt": "2023-01-12T11:49:28.906Z",
                    "cashbackType": "percentage",
                    "disableRetry": false,
                    "providerName": "NGN_INTERNAL_DEPOSIT_PROVIDER",
                    "additionalFee": 0,
                    "hasValidation": false,
                    "hasVariations": false,
                    "convinienceFee": 0,
                    "recurringCount": 0,
                    "customerBearsFee": false,
                    "hasSubVariations": false,
                    "recurringInterval": "none",
                    "convinienceFeeType": "percentage",
                    "referralCommission": 10,
                    "recurringIntervalCount": 1,
                    "referralCommissionType": "percentage"
                },
                "retryCount": 0,
                "owner": "63bff39246f4a20013a783b7",
                "createdBy": "63bff39246f4a20013a783b7",
                "client": null,
                "developer": null,
                "tags": null,
                "_id": 363,
                "createdAt": "2023-01-12T12:46:07.000Z",
                "updatedAt": "2023-01-12T12:46:08.000Z"
            },
        ]
    }
}

Last updated