Create a Card

Add a card.

Only the name property is required when adding a card. Once the card is created, the issuer can update other parameters accordingly. However, kindly keep in mind that the id, name, currency, and region attributes of each card cannot be modified.

HEADERS.

method	POST
content-type	application/json
authorization	Issuer <SECRET_KEY>
url	https://api.gastaraz.com/cards

PARAMETERS.

name string required	The unique name of the card.

REQUEST.

{
    "headers": {
        "url": "https://api.gastaraz.com/cards",
        "authorization": "ISSUER_SECRET_KEY",
        "content-type": "application/json"
    },
    "body": {
        "name": "string"
    }
}

RESPONSE.

200

{
    "status": true,
    "message": "The request was successful.",
    "data": {
        "id": "6526c1e42253e8e6614c577a",
        "name": "Waterfront Enterprise Credit Card",
        "term": "3 Months",
        "currency": "NGN",
        "limit": 5000000,
        "fees": {
            "annual": {
                "rate": "2%",
                "value": 100000
            },
            "late": {
                "rate": "0.5%",
                "value": 25000
            },
            "returned": {
                "rate": "0.5%",
                "value": 25000
            }
        },
        "interest": {
            "rate": "6%",
            "value": 300000
        },
        "apr": {
            "rate": "9%",
            "value": 450000
        },
        "cashback": {
            "rate": "2%",
            "value": 250000
        },
        "requirements": {
            "score": {
                "minimum": 500,
                "average": 700
            },
            "basic": {
                "account": "Business",
                "region": "Nigeria"
            }
        },
        "issuer": {
            "id": "6649a8012b0e227537090866",
            "name": "Waterfront Bank Plc"
        },
        "created": "Monday, July 15, 2024, 02:57 PM",
        "updated": "Friday, August 16, 2024, 11:45 AM"
    }
}

400

{
    "status": false,
    "message": "The request was not successful.",
    "data": null
}