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

# Set up a funding account

> Configures a bank account whose transfers deliver to the customer’s bound smart account. Bank transfers into it appear as orders at `GET /onramp/orders`.



## OpenAPI

````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/deposit-service.json post /onramp/accounts
openapi: 3.1.0
info:
  title: Deposit Service API
  version: 1.0.0
  description: >-
    Rhinestone Deposits API: accept deposits from any chain, asset or payment
    method, and settle them as one token on one chain.
servers:
  - url: https://v1.orchestrator.rhinestone.dev/deposit-processor
security: []
paths:
  /onramp/accounts:
    post:
      tags:
        - Onramp
      summary: Set up a funding account
      description: >-
        Configures a bank account whose transfers deliver to the customer’s
        bound smart account. Bank transfers into it appear as orders at `GET
        /onramp/orders`.
      parameters:
        - schema:
            type: string
            description: 'Integrator API key: the project’s orders'
          required: false
          description: 'Integrator API key: the project’s orders'
          name: x-api-key
          in: header
        - schema:
            type: string
            description: >-
              Customer bearer from `POST /compliance/sessions`: that customer’s
              orders only
            example: Bearer eyJhbGciOi...
          required: false
          description: >-
            Customer bearer from `POST /compliance/sessions`: that customer’s
            orders only
          name: authorization
          in: header
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOnrampAccountRequest'
      responses:
        '201':
          description: The configured account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnrampAccountCreated'
        '400':
          description: Unknown option for this currency
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Missing or invalid bearer
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: >-
            Not a customer bearer, the bearer no longer matches its customer, or
            the provider refused the customer
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: >-
            No such account for this customer, or bank transfer by virtual
            account is not provisioned for this project
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: >-
            No bound smart account, the project is not configured for deposits,
            or its whitelist or session coverage rejects the delivery route
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal failure serving the request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '502':
          description: The provider failed the request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '503':
          description: Onramp is not configured
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  schemas:
    CreateOnrampAccountRequest:
      type: object
      properties:
        provider:
          type: string
          enum:
            - noah
        currency:
          type: string
          enum:
            - EUR
            - USD
          description: Supported ISO 4217 fiat currency
        optionId:
          type: string
          format: uuid
          description: >-
            From `GET /onramp/options?provider=noah`; any matching option
            without
      required:
        - provider
        - currency
      additionalProperties: false
    OnrampAccountCreated:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/OnrampAccount'
      required:
        - account
      additionalProperties: false
    OnrampAccount:
      type: object
      properties:
        id:
          type: string
          format: uuid
        currency:
          type: string
          enum:
            - EUR
            - USD
          description: Supported ISO 4217 fiat currency
        status:
          type: string
          enum:
            - pending
            - active
            - disabled
      required:
        - id
        - currency
        - status
      additionalProperties: false

````

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