> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paychoice.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Store a bank account

Stores bank account details and returns a token to use in place of the account on later charges (pass it as `bank_token`). Returns HTTP `200` on v4 and `201 Created` on v5. `bank[bsb]` is not required for New Zealand accounts; supply the full 15–16 digit account number instead.

This response has no paging fields.

```json 201 theme={null}
{
  "bank": {
    "bank_token": "9acf4194-3651-4414-8415-6b8eb74ece6d",
    "name": "John Citizen",
    "bsb": "123123",
    "number": "XXXXX3123",
    "merchantguid": "315564b9-b863-4016-8c53-02c9d8cc80b7",
    "link": { "href": "/api/v5/bank_token/9acf4194-3651-4414-8415-6b8eb74ece6d", "rel": "self" }
  },
  "object_type": "bank"
}
```


## OpenAPI

````yaml POST /api/v5/Bank_Token
openapi: 3.0.1
info:
  title: Paychoice
  version: v5
servers: []
security:
  - basic: []
paths:
  /api/v5/Bank_Token:
    post:
      tags:
        - BankToken
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankTokenDto'
          text/json:
            schema:
              $ref: '#/components/schemas/BankTokenDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/BankTokenDto'
      responses:
        '200':
          description: OK
components:
  schemas:
    BankTokenDto:
      type: object
      properties:
        bank[name]:
          type: string
          nullable: true
        bank[bsb]:
          type: string
          nullable: true
        bank[number]:
          type: string
          nullable: true
        merchant_guid:
          type: string
          nullable: true
        token:
          type: string
          nullable: true
        firstname:
          type: string
          nullable: true
        lastname:
          type: string
          nullable: true
        email:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        accounttype:
          type: string
          nullable: true
        holdertype:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    basic:
      type: http
      description: Basic Authorization header using the Bearer scheme.
      scheme: basic

````

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