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

# Create Static Address

> Generates a static collection address based on the specified currency and network.

**Note**: If a static collection address already exists for `channelId` + `chain`, the `currencies` and `callbackUrl` in the request will update the existing bound information.

## Overview

This page documents the `POST /payment/open/institution/v1/pay/fixedaddress/save` endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

Generates a static collection address based on the specified currency and network.

## Notes

* If a static collection address already exists for `channelId` + `chain`, the `currencies` and `callbackUrl` in the request update the existing bound information.
* Authentication uses the standard GatePay signed headers.
* This page documents the standard merchant endpoint.
* For shared signing rules, see [/api-reference/version/100/en/common/securityAndSignature](/api-reference/version/100/en/common/securityAndSignature).


## OpenAPI

````yaml /api-reference/version/100/en/openapi/institution/fixed-address-openapi.json POST /payment/open/institution/v1/pay/fixedaddress/save
openapi: 3.1.0
info:
  title: GatePay API - Static Address Collection
  version: 1.0.0
servers:
  - url: https://openplatform.gateapi.io
security: []
paths:
  /payment/open/institution/v1/pay/fixedaddress/save:
    post:
      tags:
        - Static Address Collection
      summary: Create Static Collection Address
      description: >-
        Generates a static collection address based on the specified currency
        and network.


        **Note**: If a static collection address already exists for `channelId`
        + `chain`, the `currencies` and `callbackUrl` in the request will update
        the existing bound information.
      operationId: saveFixedAddress
      parameters:
        - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId'
        - $ref: '#/components/parameters/X-GatePay-Signature'
        - $ref: '#/components/parameters/X-GatePay-Timestamp'
        - $ref: '#/components/parameters/X-GatePay-Nonce'
        - $ref: '#/components/parameters/X-GatePay-On-Behalf-Of'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveFixedAddressRequest'
            examples:
              default:
                value:
                  channelId: smart_shop
                  chain: ETH
                  currencies: DAI,USDT
                  callbackUrl: https://www.abc.com/callback
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveFixedAddressResponse'
              examples:
                success:
                  value:
                    status: SUCCESS
                    code: '000000'
                    errorMessage: ''
                    data:
                      channelId: smart_shop
                      chain: ETH
                      address: '0x2EBa11a702F1d53c6e2F08278819e26E6e4a63ae'
                      currencies:
                        - DAI
                        - USDT
                      callbackUrl: https://www.abc.com/callback
                      desc: ''
                      ChainShowEn: ETH /ERC20
components:
  parameters:
    X-GatePay-Certificate-ClientId:
      name: X-GatePay-Certificate-ClientId
      in: header
      required: true
      description: >-
        The clientId assigned when the merchant registers an application in the
        Gate merchant console.
      schema:
        type: string
        example: 4186d0c6-6a35-55a9-8dc6-5312769dbff8
    X-GatePay-Signature:
      name: X-GatePay-Signature
      in: header
      required: true
      description: >-
        Request signature. GatePay uses this signature to verify whether the
        request is valid.
      schema:
        type: string
    X-GatePay-Timestamp:
      name: X-GatePay-Timestamp
      in: header
      required: true
      description: >-
        UTC timestamp in milliseconds when the request is generated. GatePay
        will not process requests where the difference from the receive time
        exceeds 10 seconds.
      schema:
        type: string
        example: '1672905655498'
    X-GatePay-Nonce:
      name: X-GatePay-Nonce
      in: header
      required: true
      description: >-
        Random string. Must comply with HTTP header rules; recommended length is
        within 32 characters, composed of digits and letters.
      schema:
        type: string
        example: '9578'
    X-GatePay-On-Behalf-Of:
      name: X-GatePay-On-Behalf-Of
      in: header
      required: true
      schema:
        type: string
      description: >-
        Required delegated-subject header. Provide the initiating account ID for
        this request. For institution merchant APIs, this is typically the
        target sub-account ID; for institution charge and transfer APIs, it can
        be either an institution account ID or a sub-account ID.
  schemas:
    SaveFixedAddressRequest:
      type: object
      required:
        - channelId
        - chain
        - currencies
        - callbackUrl
      properties:
        channelId:
          type: string
          description: >-
            Merchant channel ID, supports only letters, numbers, underscores,
            and hyphens, with a maximum length of 50 bytes
        chain:
          type: string
          description: Network name
        currencies:
          type: string
          description: >-
            Currencies to be earned at this static address, separated by commas
            (e.g., `USDT,BTC`)
        callbackUrl:
          type: string
          description: Callback URL for this channel, with a maximum length of 128 bytes
    SaveFixedAddressResponse:
      type: object
      properties:
        status:
          type: string
          description: Response result, SUCCESS or FAIL
          example: SUCCESS
          enum:
            - SUCCESS
            - FAIL
        code:
          type: string
          description: Response error code
        errorMessage:
          type: string
          description: Error description
        data:
          type: object
          properties:
            channelId:
              type: string
              description: Merchant channel ID
            chain:
              type: string
              description: Network name
            address:
              type: string
              description: Collection address
            currencies:
              type: array
              items:
                type: string
              description: List of supported currencies for this network
            callbackUrl:
              type: string
              description: Callback URL for collection notifications
            desc:
              type: string
              description: Description
            ChainShowEn:
              type: string
              description: The English name of chain

````