> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexapay.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify Settlement Bank Account

> Verifies the settlement bank account details against the provider and links it to the merchant's profile. The account name returned must match the registered business owner legal name or contact person.

Verifies and saves the business's settlement bank account. The returned account name must match the registered owner legal name or contact person.


## OpenAPI

````yaml POST /bank/verify
openapi: 3.0.0
info:
  title: NexaPay Business API
  version: 1.0.0
  description: Server-to-server merchant integration API documentation.
servers:
  - url: https://api.nexapay.ng/api/v1/business
    description: Production Server
security: []
tags: []
paths:
  /bank/verify:
    post:
      tags:
        - Transfers
      summary: Verify settlement bank account
      description: >-
        Verifies the settlement bank account details against the provider and
        links it to the merchant's profile. The account name returned must match
        the registered business owner legal name or contact person.
      parameters:
        - $ref: '#/components/parameters/BusinessEnvHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                accountNumber:
                  type: string
                  description: Settlement account number (10 digits)
                bankCode:
                  type: string
                  description: Settlement bank's CBN code (e.g. 058 for GTB)
              required:
                - accountNumber
                - bankCode
      responses:
        '200':
          description: Settlement bank account successfully verified and configured.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  msg:
                    type: string
                    example: Bank account verified and saved
                  bankAccount:
                    type: object
                    properties:
                      accountNumber:
                        type: string
                      bankName:
                        type: string
                      accountName:
                        type: string
                      bankCode:
                        type: string
                      verified:
                        type: boolean
                      verifiedAt:
                        type: string
                  businessName:
                    type: string
        '400':
          description: Invalid arguments, malformed account number, or name mismatch.
        '409':
          description: >-
            Bank account already verified, or name conflicts with another
            business record.
        '500':
          description: Internal server error.
      security:
        - ApiKeyAuth: []
components:
  parameters:
    BusinessEnvHeader:
      name: x-business-env
      in: header
      required: false
      schema:
        type: string
        enum:
          - prod
          - test
        default: prod
      description: Target environment selector (live production vs. simulated sandbox).
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

````