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

# Create Payment Link



## OpenAPI

````yaml openapi.json post /payment-link
openapi: 3.0.0
info:
  title: Monieswitch API Reference
  version: 1.0.0
  description: ''
servers: []
security:
  - bearerAuth: []
paths:
  /payment-link:
    parameters: []
    post:
      tags:
        - Payment Link
      summary: Create Payment Link
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                amountType:
                  type: string
                amount:
                  type: integer
                name:
                  type: string
                description:
                  type: string
                email:
                  type: string
                  format: email
                link:
                  type: string
                supportCard:
                  type: boolean
                supportBankTransfer:
                  type: boolean
                webhookURL:
                  type: string
                  format: uri
                callbackURL:
                  type: string
                  format: uri
                bearer:
                  type: string
                subaccountId:
                  type: string
                extraFields:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      required:
                        type: boolean
                      label:
                        type: string
                      name:
                        type: string
                      placeholder:
                        type: string
                      description:
                        type: string
                      order:
                        type: integer
                isOneTimeUse:
                  type: boolean
                logo:
                  type: string
                  format: binary
            example:
              amountType: FIXED
              amount: 300
              name: XIAOMI REDMI DONATION
              description: >-
                XIAOMI REDMI A5 - 6.88 3GB RAM/64GB ROM -- Ocean Blue↵↵Processor
                : UNI
              email: access2emma@gmail.com
              supportCard: true
              supportBankTransfer: true
              webhookURL: https://webhook.site/90c92062-f0a8-4deb-a36e-da774a702f1c
              callbackURL: https://webhook.site/90c92062-f0a8-4deb-a36e-da774a702f1c
              bearer: account
              subaccountId: bb4ef1f3-68a8-4856-9e02-c27bf1b847e3
      responses:
        '201':
          headers:
            Content-Security-Policy:
              schema:
                type: string
              example: >-
                default-src 'self';base-uri 'self';font-src 'self' https:
                data:;form-action 'self';frame-ancestors 'self';img-src 'self'
                data:;object-src 'none';script-src 'self';script-src-attr
                'none';style-src 'self' https:
                'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Opener-Policy:
              schema:
                type: string
              example: same-origin
            Cross-Origin-Resource-Policy:
              schema:
                type: string
              example: same-origin
            Origin-Agent-Cluster:
              schema:
                type: string
              example: '?1'
            Referrer-Policy:
              schema:
                type: string
              example: no-referrer
            Strict-Transport-Security:
              schema:
                type: string
              example: max-age=15552000; includeSubDomains
            X-Content-Type-Options:
              schema:
                type: string
              example: nosniff
            X-DNS-Prefetch-Control:
              schema:
                type: string
              example: 'off'
            X-Download-Options:
              schema:
                type: string
              example: noopen
            X-Frame-Options:
              schema:
                type: string
              example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              schema:
                type: string
              example: none
            X-XSS-Protection:
              schema:
                type: integer
              example: '0'
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Access-Control-Allow-Credentials:
              schema:
                type: boolean
              example: 'true'
            Access-Control-Expose-Headers:
              schema:
                type: string
              example: >-
                Pragma,Expires,x-pub-key,Content-Type,Authorization,Cache-Control,X-Login-Token,X-Access-Token,Content-Language,X-Partner-Access-Token,ngrok-skip-browser-warning
            Content-Type:
              schema:
                type: string
              example: application/json; charset=utf-8
            Content-Length:
              schema:
                type: integer
              example: '902'
            ETag:
              schema:
                type: string
              example: W/"386-ShBoPDM40CzaJE0rt5Mqm51vqDc"
            Vary:
              schema:
                type: string
              example: Accept-Encoding
            Date:
              schema:
                type: string
              example: Tue, 22 Apr 2025 15:15:07 GMT
            Connection:
              schema:
                type: string
              example: keep-alive
            Keep-Alive:
              schema:
                type: string
              example: timeout=5
          description: Create Payment Link - Successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      link:
                        type: string
                        format: uri
                      name:
                        type: string
                      logo:
                        type: string
                        format: uri
                      email:
                        type: string
                        format: email
                      amount:
                        type: integer
                      bearer:
                        type: string
                      reference:
                        type: string
                      amountType:
                        type: string
                      webhookURL:
                        nullable: true
                      description:
                        type: string
                        format: style
                      createdAt:
                        type: string
                        format: date-time
              example:
                status: true
                message: Payment link created successfully
                data:
                  id: 14340e69-d632-46c0-abb0-afc7d486f24e
                  link: http://localhost:3001/65j83QBEcCVGFlVQxIOLvlxhwn2rsn
                  name: XIAOMI REDMI DONATION
                  logo: >-
                    https://d1hhqx6q67lhms.cloudfront.net/Ck2jHba7OzcBAbvsbt9Dxj2iF_Background-Image-2x.jpg
                  email: access2emma@gmail.com
                  amount: 3700
                  bearer: account
                  reference: GZhxwXkeCYmSGno4Rdy6fn1ixgEhIa
                  amountType: FIXED
                  webhookURL: null
                  description: |-
                    XIAOMI REDMI A5 - 6.88 3GB RAM/64GB ROM -- Ocean Blue

                    Processor : UNI
                  createdAt: '2025-08-05T20:21:14.826Z'
        '400':
          headers:
            Content-Security-Policy:
              schema:
                type: string
              example: >-
                default-src 'self';base-uri 'self';font-src 'self' https:
                data:;form-action 'self';frame-ancestors 'self';img-src 'self'
                data:;object-src 'none';script-src 'self';script-src-attr
                'none';style-src 'self' https:
                'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Opener-Policy:
              schema:
                type: string
              example: same-origin
            Cross-Origin-Resource-Policy:
              schema:
                type: string
              example: same-origin
            Origin-Agent-Cluster:
              schema:
                type: string
              example: '?1'
            Referrer-Policy:
              schema:
                type: string
              example: no-referrer
            Strict-Transport-Security:
              schema:
                type: string
              example: max-age=15552000; includeSubDomains
            X-Content-Type-Options:
              schema:
                type: string
              example: nosniff
            X-DNS-Prefetch-Control:
              schema:
                type: string
              example: 'off'
            X-Download-Options:
              schema:
                type: string
              example: noopen
            X-Frame-Options:
              schema:
                type: string
              example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              schema:
                type: string
              example: none
            X-XSS-Protection:
              schema:
                type: integer
              example: '0'
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Access-Control-Allow-Credentials:
              schema:
                type: boolean
              example: 'true'
            Content-Type:
              schema:
                type: string
              example: application/json; charset=utf-8
            Content-Length:
              schema:
                type: integer
              example: '106'
            ETag:
              schema:
                type: string
              example: W/"6a-R2IKCBxNBtcCfSZCDH1SfM/doeA"
            Vary:
              schema:
                type: string
              example: Accept-Encoding
            Date:
              schema:
                type: string
              example: Wed, 15 Nov 2023 15:31:22 GMT
            Connection:
              schema:
                type: string
              example: keep-alive
            Keep-Alive:
              schema:
                type: string
              example: timeout=5
          description: Create Payment Link - Existing link
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
              example:
                message: You specified an already existing link
                status: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````