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

# Get Bank Codes

> You can get the banks your customers can pay from with a payin method. Each bank appears once, sorted by bank name.
Use a `bank_code` from this list in `payin_method_params` when you create the payin.
Currently we only support bank codes for payin method `my_bank_fpx_myr`.



## OpenAPI

````yaml /api/openapi/v2-reference.yaml get /v2/payins/bank_codes
openapi: 3.0.2
info:
  title: Multi-currency Payment APIs
  description: >-
    ## Introduction

    The Multi-currency Payment API Solution provides developers with a unified
    API schema to support multiple currencies efficiently. These APIs enable
    seamless transactions for both payin and payout operations, ensuring a
    robust, reliable, and scalable payment infrastructure for businesses dealing
    with various currencies.

    ### Key Features

    - **Single API Schema**: A single schema supports all currencies in your
    account, simplifying integration and management.

    - **Payin and Payout Process**:
      - **Step 1**: Call the **Get payin method list** to retrieve the list of supported methods.
      - **Step 2**: Call the **Get payin required fields** to get specific required fields for each method.
      - **Step 3**: Create the payment using the method and required fields from the previous step.
      - **Step 4**: On the sandbox environment, you can call the **Simulate payin** to simulate the payment.

    <div class="gst-note-red">
      Please note: GST should only be set to <code>true</code> for AU Merchants for <b>AUD</b> currency only. For all other currencies, set GST to <code>false</code>.
    </div>

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  version: 2.0.0
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security:
  - app-id: []
    secret-key: []
paths:
  /v2/payins/bank_codes:
    get:
      tags:
        - Payin
      summary: Get Bank Codes
      description: >-
        You can get the banks your customers can pay from with a payin method.
        Each bank appears once, sorted by bank name.

        Use a `bank_code` from this list in `payin_method_params` when you
        create the payin.

        Currently we only support bank codes for payin method `my_bank_fpx_myr`.
      parameters:
        - name: payin_method_name
          in: query
          schema:
            type: string
          description: Payin method name
          required: true
          example: my_bank_fpx_myr
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  records:
                    type: array
                    description: Empty when the payin method is not enabled on your account
                    items:
                      type: object
                      properties:
                        bank_code:
                          type: string
                          description: Bank code
                          example: BCBB0235
                        bank_name:
                          type: string
                          description: Bank name
                          example: CIMB Bank Berhad
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
              example:
                errors:
                  code: REQUIRE_LOGIN
                  message: Not Authorised
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      message:
                        type: string
              example:
                errors:
                  message: payin_method_name is required
      x-codeSamples:
        - lang: cURL
          source: |
            curl --request GET \
              --url 'https://api.cleverhub.co/api/v2/payins/bank_codes?payin_method_name=my_bank_fpx_myr' \
              --header 'app-id: <api-key>' \
              --header 'secret-key: <api-key>'
components:
  securitySchemes:
    app-id:
      type: apiKey
      in: header
      name: app-id
      description: |
        A unique identifier assigned to each application.
    secret-key:
      type: apiKey
      in: header
      name: secret-key
      description: |
        A secure token associated with the `app-id`.

````

## Related topics

- [Get Bank Codes](https://docs.helloclever.co/api/payout/get-bank-codes.md)
- [Multi-Currency Payout API Reference](https://docs.helloclever.co/api/v2/payout.md)
- [Multi-Currency Payin API Reference](https://docs.helloclever.co/api/v2/payin.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.