Financial Module

Banks & Cards

Manage financial assets and linked accounts. This module allows users to discover supported banking institutions and securely register payment cards to their digital wallet.

GET

Fetch Supported Banks

Retrieve a list of all banking institutions supported by the ShieldPay ecosystem for card binding and transfers.

Endpoint


                http://shield-pay.adhameldouh.com/api/v1/banks

Header Requirement

Auth Bearer {TOKEN}

JSON Response

200 OK

{
    "success": true,
    "message": "Banks retrieved successfully",
    "data": [
        {
            "id": 1,
            "name": "National Bank of Egypt",
            "code": "NBE"
        }
    ]
}

POST

Register Payment Card

Securely link a credit or debit card to the user's account. This action is required to enable wallet charging and peer-to-peer transfers.

Endpoint


                http://shield-pay.adhameldouh.com/api/v1/cards/register

Request Body

Param	Type	Required
bank_id	integer	YES
card_number	string (16)	YES
card_holder_name	string	YES
bank_id	integer	YES
expiry_date	string (MM/YY)	YES
cvv	string (3 digits)	YES

JSON Response

201 Created

{
    "success": true,
    "message": "Bank card linked successfully!",
    "card": {
        "id": 1,
        "bank": "National Bank of Egypt"
        "card_number": "**** **** **** 5678",
        "registered_at": "2026-01-29",
    }
}