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

# List Of Acceptable IDs

> This endpoint shows the list of acceptable identification documents in various countries for the creation of Euro subaccounts.



## OpenAPI

````yaml /openapi.json get /payaza-account/api/v1/euro/acceptable-ids
openapi: 3.0.1
info:
  title: Payaza Documentation
  version: 2.0.0
  description: >-
    API reference for processing payments using Card, Bank Transfer, USSD, and
    QR Code methods.
servers:
  - url: https://api.payaza.africa/live
security:
  - ApiKeyAuth: []
  - TenantID: []
  - ProductID: []
tags:
  - name: Transfers
    description: >-
      Transfers are transactions made from your Payaza account to beneficiaries.
      Merchants can instantly transfer funds from their available balance. For
      every transfer, you need to specify the amount and the beneficiary’s
      details. You become eligible to make transfers after you have been
      verified. (you sign up, finish account activation and KYC verification).
  - name: Payaza Account
    description: >-
      This is our internal account that can be used to make payouts to other
      bank accounts, in single or in bulk. The Payaza account can also be used
      to receive settlements. It can also be used to track the transfer status
      of your transactions and check your balance instantly
  - name: Sub Accounts
    description: >-
      This enables you to establish Sub Payaza accounts for your customers. Each
      sub-account comes with an assigned static virtual account, facilitating
      direct funding for individual accounts. Furthermore, the Main Payaza
      account can directly initiate funding for each sub-account. These
      sub-accounts serve the purpose of managing unique account positions or
      balances and facilitating disbursements from these positions to specified
      beneficiaries.
  - name: EUR Accounts
    description: >-
      This endpoints enable you to create EUR subaccounts which can be used to
      make transfers as required .
  - name: Apple Pay and Google Pay
    description: >-
      Apple Pay and Google Pay give your customers a fast, familiar, and secure
      way to complete payments. Our APIs provide a gateway to provide these
      services to your users for a smooth payment experience.
  - name: Virtual Accounts
    description: >-
      Virtual Accounts are bank accounts that are created for a specific purpose
      and last for specified durations. Virtual accounts are issued by Payaza’s
      partner banks. Our virtual account APIs can be used to create virtual
      accounts and perform other tasks relevant to virtual accounts. Virtual
      accounts are created to foster easy payment collections for your business
      and platform. 

      Static/Reserved Account: This virtual account is created by the merchant
      and remains valid indefinitely. It can be used multiple times and does not
      expire. 

      Dynamic Account: This virtual account is generated for a specific
      transaction or purpose. Please note that dynamic virtual account remains
      valid for a temporary period of time or until a payment of the specified
      amount is received. Upon expiry, a merchant can generate another one for a
      different purpose.
  - name: Card Collection
    description: >-
      The Card Collection APIs can be used to make card transactions, refund
      transactions that have been performed, check the status of a transaction
      and so much more.
  - name: Card Tokenisation
    description: >-
      The Card Tokenisation APIs are used to create card tokens, charge cards
      using tokens, retrieve all tokens created by a merchant account and
      deleting any card token as desired.
  - name: Refunds And Chargebacks
    description: >-
      The Refunds and Chargeback APIs are used to initiate refunds, view your
      refund and chargeback history and so much more.
  - name: Branches
    description: >-
      The Refunds and Chargeback APIs are used to initiate refunds, view your
      refund and chargeback history and so much more.
  - name: Auth-Capture-Void
    description: >-
      The Auth-Capture-Void APIs provide a two-phase payment process where
      transactions are first authorized, then captured or voided. This allows
      merchants to hold funds and complete the transaction in the future.
  - name: Momo and ZAR Collections
    description: APIs for MoMo, ZAR and XOF collections.
  - name: Check Transaction Status(Merchant Reference)
    description: >-
      This endpoint is used to check the transaction status of a transaction
      using the Merchant Reference..
paths:
  /payaza-account/api/v1/euro/acceptable-ids:
    get:
      tags:
        - EUR Accounts
      summary: List Of Acceptable IDs
      description: >-
        This endpoint shows the list of acceptable identification documents in
        various countries for the creation of Euro subaccounts.
      responses:
        '200':
          description: List of Acceptable IDs Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/listOfAcceptableIdsResponse'
              examples:
                List Of Acceptable IDs:
                  summary: List Of Acceptable IDs
                  value:
                    status: true
                    message: Country Documents
                    data:
                      - id: b362187b-47aa-41ff-8978-73d5893ea5fa
                        country: Nigeria
                        countryShort: NG
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: false
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: b2547d05-f533-4241-a814-ecd3bbddd851
                        country: United Kingdom (GBP)
                        countryShort: UK
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: true
                          identityCard: false
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 2a1e13a7-96e9-4a22-aa6b-3868100a33fa
                        country: France
                        countryShort: FR
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: true
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: bfdafa95-61e5-4b57-843f-104c378145a1
                        country: Germany
                        countryShort: DE
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: true
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 1bb6071b-7934-4958-8deb-8598ef6b6ea9
                        country: Italy
                        countryShort: IT
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: true
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 48142897-a6c4-4559-bf49-9e7e9690fbed
                        country: Spain
                        countryShort: ES
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: true
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 014f3d4b-0d6f-474b-9385-891d372d2d54
                        country: Benin (XOF)
                        countryShort: BJ
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: false
                          residencePermit: true
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 7272af4a-3be8-4fe2-b500-1229ceb5b2d5
                        country: Mali (XOF)
                        countryShort: ML
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: false
                          residencePermit: false
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 6d89a00e-bac0-4ef7-97bc-898212a7d1df
                        country: Togo (XOF)
                        countryShort: TG
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: false
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 4d28475f-4d5f-4515-a27d-c6d1be4f25f9
                        country: Côte d'Ivoire (XOF)
                        countryShort: CI
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: false
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                      - id: 69362fd2-9e23-4c66-a4f3-5a19bce5998d
                        country: United States of America (USD)
                        countryShort: US
                        createdAt: null
                        acceptedIDDocuments:
                          passport: true
                          drivingLicense: true
                          residencePermit: false
                          identityCard: true
                        acceptedPOADocuments:
                          utilityBill: true
                          bankStatement: true
                    code: 200
        '400':
          description: Payment failed
      security:
        - ApiKeyAuth:
            - Payaza {{Public API Key In Base64}}
          TenantID:
            - test or live
components:
  schemas:
    listOfAcceptableIdsResponse:
      title: Country Documents Response
      type: object
      properties:
        status:
          type: boolean
          description: Request status.
          example: true
        message:
          type: string
          description: Response message.
          example: Country Documents
        code:
          type: integer
          description: HTTP status code.
          example: 200
        data:
          type: array
          description: List of countries and their accepted document types.
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                description: Unique identifier for the country configuration.
                example: b362187b-47aa-41ff-8978-73d5893ea5fa
              country:
                type: string
                description: Full name of the country (may include currency).
                example: Nigeria
              countryShort:
                type: string
                description: ISO 2-character country code.
                example: NG
              createdAt:
                type: string
                format: date-time
                nullable: true
                description: Timestamp of creation (if available).
              acceptedIDDocuments:
                type: object
                description: Boolean flags indicating accepted identity documents.
                properties:
                  passport:
                    type: boolean
                    description: Is Passport accepted?
                    example: true
                  drivingLicense:
                    type: boolean
                    description: Is Driving License accepted?
                    example: true
                  residencePermit:
                    type: boolean
                    description: Is Residence Permit accepted?
                    example: false
                  identityCard:
                    type: boolean
                    description: Is National Identity Card accepted?
                    example: true
              acceptedPOADocuments:
                type: object
                description: Boolean flags indicating accepted Proof of Address documents.
                properties:
                  utilityBill:
                    type: boolean
                    description: Is Utility Bill accepted?
                    example: true
                  bankStatement:
                    type: boolean
                    description: Is Bank Statement accepted?
                    example: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Payaza {{Public API Key in Base 64}}
    TenantID:
      type: apiKey
      in: header
      name: X-TenantID
      description: live or test
    ProductID:
      type: apiKey
      in: header
      name: X-ProductID
      description: 'default value is ‟app” '

````