> ## 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.

# Fund Transfer to Store



## OpenAPI

````yaml openapi.json post /branch/terminal/debit
openapi: 3.0.0
info:
  title: Monieswitch API Reference
  version: 1.0.0
  description: ''
servers: []
security:
  - bearerAuth: []
paths:
  /branch/terminal/debit:
    parameters: []
    post:
      tags:
        - Branches
        - Virtual Terminal
      summary: Fund Transfer to Store
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pin:
                  type: string
                  format: utc-millisec
                amount:
                  type: integer
                terminalId:
                  type: string
                narration:
                  type: string
            example:
              pin: '2222'
              amount: 500
              terminalId: 28cc1855-2ff4-4a40-9df2-32aefb06eada
              narration: First terminal transfer
      responses:
        '200':
          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,ngrok-skip-browser-warning
            Content-Type:
              schema:
                type: string
              example: application/json; charset=utf-8
            ETag:
              schema:
                type: string
              example: W/"46a-qkqunbp/7q60Yh97Uv5DnHULZ2s"
            Vary:
              schema:
                type: string
              example: Accept-Encoding
            Content-Encoding:
              schema:
                type: string
              example: gzip
            Date:
              schema:
                type: string
              example: Thu, 02 Jan 2025 12:25:44 GMT
            Connection:
              schema:
                type: string
              example: keep-alive
            Keep-Alive:
              schema:
                type: string
              example: timeout=5
            Transfer-Encoding:
              schema:
                type: string
              example: chunked
          description: Fund Transfer to Store - Succesful
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      paidAt:
                        type: string
                        format: date-time
                      reference:
                        type: string
                      totalAmount:
                        type: integer
                      charges:
                        type: integer
                      status:
                        type: string
                      amount:
                        type: integer
                      merchantId:
                        type: string
                      walletId:
                        type: string
                      category:
                        type: string
                      terminalId:
                        type: string
                      terminalName:
                        type: string
                      storeId:
                        type: string
                      toWalletId:
                        type: string
                      narration:
                        type: string
                      storeName:
                        type: string
                      fromWalletId:
                        type: string
                      beneficiaryBankName:
                        type: string
                      beneficiaryBankCode:
                        type: string
                        format: color
                      providerWalletId:
                        type: string
                      beneficiaryAccountNumber:
                        type: string
                        format: utc-millisec
                      beneficiaryAccountName:
                        type: string
                      originatorBankCode:
                        type: string
                        format: color
                      originatorBankName:
                        type: string
                      originatorAccountName:
                        type: string
                      originatorAccountNumber:
                        type: string
                        format: utc-millisec
                      description:
                        type: string
                      transactionId:
                        type: string
              example:
                status: true
                message: Wallet transfer successfully completed.
                data:
                  paidAt: '2025-01-02T12:25:42.389Z'
                  reference: zOBF4xQTZP3OWmup39DcTt3Izn4Z1s0avcta
                  totalAmount: 80
                  charges: 0
                  status: SUCCESS
                  amount: 80
                  merchantId: bb80715c-dcbc-460c-a8e4-203b63b03fce
                  walletId: 51d7b035-7317-4578-868e-d25eed1b5bf7
                  category: TERMINAL_TO_STORE
                  terminalId: 28cc1855-2ff4-4a40-9df2-32aefb06eada
                  terminalName: Lambe 01
                  storeId: 9ab67f41-10c9-4f52-adfc-31f460980966
                  toWalletId: 1e04b3a0-eabd-48b4-b5ba-91ec1d15a103
                  narration: First terminal transfer
                  storeName: Lambe Shop
                  fromWalletId: 51d7b035-7317-4578-868e-d25eed1b5bf7
                  beneficiaryBankName: Xpress Wallet
                  beneficiaryBankCode: '999270'
                  providerWalletId: 46e55be2-0086-4d4b-973a-5f69c1a226c1
                  beneficiaryAccountNumber: '4478164596'
                  beneficiaryAccountName: Neyosoft/Lambe Shop
                  originatorBankCode: '999270'
                  originatorBankName: Xpress Wallet
                  originatorAccountName: Neyosoft/Lambe 01
                  originatorAccountNumber: '4446474425'
                  description: ₦80.00 transferred to Terminal(Lambe 01)
                  transactionId: af7b9a15-10f7-4949-93fe-046b642aece2
        '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'
            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,ngrok-skip-browser-warning
            Content-Type:
              schema:
                type: string
              example: application/json; charset=utf-8
            Content-Length:
              schema:
                type: integer
              example: '88'
            ETag:
              schema:
                type: string
              example: W/"58-ktCKpQVF//PZsGX2TeAg++LRqHk"
            Vary:
              schema:
                type: string
              example: Accept-Encoding
            Date:
              schema:
                type: string
              example: Tue, 31 Dec 2024 17:34:00 GMT
            Connection:
              schema:
                type: string
              example: keep-alive
            Keep-Alive:
              schema:
                type: string
              example: timeout=5
          description: Fund Transfer to Store - Insufficient balance
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
              example:
                status: false
                message: There is no sufficient balance to complete this transaction
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````