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

# Create an instant payment



## OpenAPI

````yaml /api-reference/openapi.yaml post /v2/payments/external_entity/instant
openapi: 3.0.3
info:
  title: Rise
  description: Web3-enabled payroll and compliance for the modern workforce
  version: 2.0.0
servers:
  - url: https://b2b-api.dev-riseworks.io
    description: Development
  - url: https://integrations-api.staging-riseworks.io
    description: Staging
  - url: https://integrations-api.riseworks.io
    description: Production
security: []
paths:
  /v2/payments/external_entity/instant:
    post:
      tags:
        - B2B Bill Pay
      summary: Create an instant payment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                from:
                  type: string
                  minLength: 15
                  maxLength: 15
                  pattern: ^te-.*
                  description: >-
                    Identifier of a Rise team (a workspace below a company).
                    15-character nanoid prefixed with `te-`.
                amount_cents:
                  type: integer
                  minimum: 100
                  maximum: 10000000000
                currency_symbol:
                  default: USD
                  type: string
                  enum:
                    - USD
                network:
                  default: arbitrum
                  type: string
                  enum:
                    - arbitrum
                payment_data:
                  type: object
                  properties:
                    role_description:
                      type: string
                      minLength: 1
                      maxLength: 500
                    invoice_description:
                      type: string
                      minLength: 1
                      maxLength: 5000
                    services_description:
                      default: ''
                      type: string
                    payment_details:
                      default: ''
                      type: string
                    rise_sow:
                      type: boolean
                    sow_link:
                      type: string
                      pattern: ^(|http(s?):\/\/[^\s]+)$
                      description: >-
                        Optional website URL — empty string or http(s) URL with
                        no whitespace.
                    reason_id:
                      type: number
                  required:
                    - role_description
                    - invoice_description
                    - rise_sow
                external_recipient_email:
                  type: string
              required:
                - from
                - amount_cents
                - payment_data
                - external_recipient_email
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      domain:
                        type: object
                        properties:
                          name:
                            type: string
                          version:
                            type: string
                          chainId:
                            type: number
                          verifyingContract:
                            type: string
                            pattern: ^0x[a-fA-F0-9]{40}$
                            description: >-
                              EVM address (0x + 40 hex chars) or null/empty for
                              unknown.
                        required:
                          - name
                          - version
                          - chainId
                          - verifyingContract
                        additionalProperties: false
                      types:
                        type: object
                        properties:
                          CreatePaymentForwardRequest:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                type:
                                  type: string
                              required:
                                - name
                                - type
                              additionalProperties: false
                          RisePayment:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                type:
                                  type: string
                              required:
                                - name
                                - type
                              additionalProperties: false
                        required:
                          - CreatePaymentForwardRequest
                          - RisePayment
                        additionalProperties: false
                      typed_data:
                        type: object
                        properties:
                          from:
                            type: string
                            pattern: ^0x[a-fA-F0-9]{40}$
                            description: >-
                              EVM address (0x + 40 hex chars) or null/empty for
                              unknown.
                          to:
                            type: string
                            pattern: ^0x[a-fA-F0-9]{40}$
                            description: >-
                              EVM address (0x + 40 hex chars) or null/empty for
                              unknown.
                          salt:
                            type: string
                          expires:
                            type: string
                          data:
                            type: object
                            properties:
                              id:
                                type: string
                              groupID:
                                type: string
                              payAtTime:
                                type: string
                              validMinutes:
                                type: string
                              payType:
                                type: string
                              token:
                                type: string
                                pattern: ^0x[a-fA-F0-9]{40}$
                                description: >-
                                  EVM address (0x + 40 hex chars) or null/empty
                                  for unknown.
                              recipient:
                                type: string
                                pattern: ^0x[a-fA-F0-9]{40}$
                                description: >-
                                  EVM address (0x + 40 hex chars) or null/empty
                                  for unknown.
                              amount:
                                type: string
                              data:
                                type: string
                            required:
                              - id
                              - groupID
                              - payAtTime
                              - validMinutes
                              - payType
                              - token
                              - recipient
                              - amount
                              - data
                            additionalProperties: false
                        required:
                          - from
                          - to
                          - salt
                          - expires
                          - data
                        additionalProperties: false
                      primary_type:
                        type: string
                    required:
                      - domain
                      - types
                      - typed_data
                      - primary_type
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: string
                  error_code:
                    type: string
                required:
                  - success
                  - data
                additionalProperties: false
                description: Bad Request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: string
                  error_code:
                    type: string
                required:
                  - success
                  - data
                additionalProperties: false
                description: Unauthorized
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: string
                  error_code:
                    type: string
                required:
                  - success
                  - data
                additionalProperties: false
                description: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: string
                  error_code:
                    type: string
                required:
                  - success
                  - data
                additionalProperties: false
                description: Not Found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: string
                  error_code:
                    type: string
                required:
                  - success
                  - data
                additionalProperties: false
                description: Internal Server Error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````