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

# Register Payin Account Asset

> Register a wallet's address for an asset on a provider account, a prerequisite for both payins (the wallet receives the delivered asset) and payouts (the wallet funds the withdrawal). Returns the updated account.



## OpenAPI

````yaml /openapi.yaml post /payins/accounts/assets
openapi: 3.1.0
info:
  version: 2.0.15
  title: Dfns
servers:
  - url: https://api.dfns.io
    description: Default - Europe
  - url: https://api.uae.dfns.io
    description: UAE
  - url: https://api.dfns.ninja
    description: <Deprecated> Staging
security: []
paths:
  /payins/accounts/assets:
    post:
      tags:
        - Payins
      summary: Register Payin Account Asset
      description: >-
        Register a wallet's address for an asset on a provider account, a
        prerequisite for both payins (the wallet receives the delivered asset)
        and payouts (the wallet funds the withdrawal). Returns the updated
        account.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    provider:
                      type: string
                      enum:
                        - Borderless
                    borderlessAccountId:
                      type: string
                      description: The Borderless account to register the asset on.
                    walletId:
                      type: string
                      minLength: 1
                      maxLength: 64
                      pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
                      description: >-
                        The wallet whose address becomes the delivery
                        destination for the asset.
                      example: wa-5pfuu-9euek-h0odgb6snva8ph3k
                    asset:
                      oneOf:
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - Erc20
                            contract:
                              type: string
                              description: >-
                                The ERC-20 contract address of the asset to
                                deliver.
                          required:
                            - kind
                            - contract
                          title: ERC-20 Asset
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - Spl
                                - Spl2022
                            mint:
                              type: string
                              description: The token mint address of the asset to deliver.
                          required:
                            - kind
                            - mint
                          title: SPL/SPL-2022 Asset
                      description: >-
                        The asset to deliver on-chain. Must be supported by
                        Borderless on the wallet network.
                  required:
                    - provider
                    - borderlessAccountId
                    - walletId
                    - asset
                  title: Borderless Register Payin Account Asset
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  accountId:
                    type: string
                    description: The provider's account id.
                  name:
                    type: string
                    description: The account name, when the provider has one.
                  assets:
                    type: array
                    items:
                      type: object
                      properties:
                        asset:
                          type: string
                          description: The provider's asset code (e.g. USDC_ETHEREUM).
                        address:
                          type: string
                          description: The registered destination address for the asset.
                      required:
                        - asset
                        - address
                    description: >-
                      The assets registered on the account, with their
                      destination addresses.
                required:
                  - accountId
                  - assets
      security:
        - authenticationToken: []
          userActionSignature: []
components:
  securitySchemes:
    authenticationToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        **Bearer Token:** Used to authenticate API requests.

        More details how to generate the token: [Authentication
        flows](https://docs.dfns.co/api-reference/auth/login-flows)
    userActionSignature:
      type: apiKey
      in: header
      name: X-DFNS-USERACTION
      description: >-
        **User Action Signature:** Used to sign the change-inducing API
        requests.

        More details how to generate the token: [User Action Signing
        flows](https://docs.dfns.co/api-reference/auth/signing-flows)

````