Bank Accounts

This guide explains how to interact with the Bank Accounts API in the Sumaya369. The Bank Accounts API provides access to the system's banking information, which is essential for processing bank transfer payments. It allows clients to retrieve bank account details for completing payments.

List Bank Accounts

Retrieve a list of available bank accounts and supported transfer sources. This endpoint returns both the bank account details needed for bank transfers and the available transfer source options (like online Saudi Arabia or Egypt). The returned data helps implement a complete bank transfer payment flow by providing all necessary banking information.

Endpoint

• Method: GET
• URL: /v1/mobile/bank-accounts

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer (token)	Yes

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "bank_accounts": [
            {
                "id": "41256465-2984-4065-8a43-dc3ce1cea742",
                "bank_name": "بنك الإنماء - INMA BANK",
                "account_number": "68201798346000",
                "IBAN": "SA9505000068201798346000",
                "country": "السعودية",
                "owner_name": "Elyak Co",
                "swift_code": "INMASARI"
            }
        ],
        "bank_transfer_source": [
            {
                "label": "السعودية",
                "value": "Saudi Arabia"
            },
            {
                "label": "ليبيا",
                "value": "Libya"
            },
            {
                "label": "السودان",
                "value": "Sudan"
            },
            {
                "label": "العراق",
                "value": "Iraq"
            },
            {
                "label": "الجزائر",
                "value": "Algeria"
            },
            {
                "label": "سوريا",
                "value": "Syria"
            },
            {
                "label": "لبنان",
                "value": "Lebanon"
            },
            {
                "label": "المغرب",
                "value": "Morocco"
            },
            {
                "label": "الكويت",
                "value": "Kuwait"
            },
            {
                "label": "تونس",
                "value": "Tunisia"
            },
            {
                "label": "مصر",
                "value": "Egypt"
            },
            {
                "label": "الاردن",
                "value": "Jordan"
            },
            {
                "label": "فلسطين",
                "value": "Palestine"
            },
            {
                "label": "تركيا",
                "value": "Turkey"
            },
            {
                "label": "اليمن",
                "value": "Yemen"
            },
            {
                "label": "باي بال",
                "value": "PayPal"
            },
            {
                "label": "أخرى",
                "value": "Other"
            }
        ]
    },
    "status_code": 200
}

Example Implementation Flow

1. Bank Account Listing
   • Application sends request to /v1/mobile/bank-accounts
   • Display list of available bank accounts
   • Show bank transfer source options

Key Considerations

• Returns both bank account details and transfer source options
• Bank accounts include full banking information (name, account number, IBAN)
• Transfer source options are localized based on translations
• Suitable for implementing bank transfer payment flows
• Provides necessary information for manual payment verification