Decentro9647 Client API

openapi: 3.2.0
info:
  title: Client API
  version: '1.0'
servers:
- url: https://your.custom.endpoint.com
security:
- {}
tags:
- name: Client
paths:
  /client/custom/endpoint:
    post:
      summary: Remitter whitelisting Callback
      description: This callback is to inform the clients about the final status of the account whitelisting request to Decentro.
      operationId: remitter-whitelisting-callback
      parameters:
      - name: your_custom_header_1
        in: header
        description: 'The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : '' " ~ ` ? = + ) ('
        schema:
          type: string
      - name: your_custom_header_2
        in: header
        description: 'The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : '' " ~ ` ? = + ) ('
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                callback_attempt:
                  type: string
                  description: Number of times the callback has been attempted.
                callback_timestamp:
                  type: string
                  description: Timestamp of the callback. Not the timestamp of the transaction.
                callback_txn_id:
                  type: string
                  description: Unique identifier mapped to the callback attempt.
                original_callback_txn_id:
                  type: string
                  description: Unique identifier mapped to the first callback attempt.
                decentro_txn_id:
                  type: string
                  description: The unique transaction identifier generated by Decentro for each request.
                request_status:
                  type: string
                  description: 'The request status after the admin action on the remitter details. Possible values: ACCEPTED/REJECTED'
                whitelisting_status:
                  type: string
                  description: 'The whitelisting status of the remitter account details. Possible values: ACTIVE/INACTIVE'
                message:
                  type: string
                  description: The description of the whitelisting status of the remitter account.
                mapped_to_virtual_account_list:
                  type: object
                  description: List of virtual details against which the remitter account is whitelisted.
                  properties:
                    custom_va_number:
                      type: string
                      description: 'The suffix part of the VA that uniquely identifies each VA. It can be from 6 -10 digit. Eg: va_suffix will be 000001 for virtual account number 46525000001'
                    virtual_account_number:
                      type: string
                      description: Virtual account number as requested by the platform.
                    customer_va_identifier:
                      type: string
                      description: Unique customer identifier that is mapped against the virtual account.
                whitelisting_account_details:
                  type: object
                  description: The details of the remitter account that is to be whitelisted
                  properties: {}
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Client
  /client/test/endpoint:
    post:
      summary: Pre-Deposit Check callback
      description: This callback allows clients to validate a transaction before the actual fund movement happens in the virtual account. The client can accept or reject incoming funds via this callback.
      operationId: pre-deposit-check-callback-1
      parameters:
      - name: your_custom_key_1
        in: header
        description: 'The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : '' \" ~ ` ? = + ) ('
        schema:
          type: string
      - name: your_custom_key_2
        in: header
        description: 'The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : '' \" ~ ` ? = + ) ('
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - amount
              - bank_reference_number
              - consumer_urn
              - decentro_txn_id
              - payee_account_number
              - payer_account_number
              - transfer_type
              properties:
                amount:
                  type: string
                  description: The transaction amount that will be collected in the virtual account.
                bank_reference_number:
                  type: string
                  description: The unique transaction reference number from the bank partner
                consumer_urn:
                  type: string
                  description: A unique identifier assigned to each merchant by Decentro during Onboarding.
                decentro_txn_id:
                  type: string
                  description: The unique transaction identifier of Decentro, passed against each payment transaction.
                payee_account_number:
                  type: string
                  description: The virtual account of Merchant at Decentro's end where the funds will be stored, if accepted.
                payer_account_number:
                  type: string
                  description: Account number of the payer/remitter.
                payer_account_ifsc:
                  type: string
                  description: Account ifsc of the payer/remitter.
                payer_name:
                  type: string
                  description: Name of the payer if propagated by the partner bank.
                transfer_type:
                  type: string
                  description: 'The transafer type of the E collect transaction. Possible values: IMPS, NEFT, RTGS'
            examples:
              'Success: Pre deposit check callback':
                value:
                  consumer_urn: F5FC3D989A2845479DB0XXXXXXXXXXXX
                  payee_account_number: 462515XXXXXXXXXX
                  transfer_type: NEFT
                  amount: 100000
                  payer_name: Test client name
                  payer_account_number: 02XXXXXXXXXXXX
                  payer_account_ifsc: HDFC1234
                  bank_reference_number: 11XXXXXXXXXXXX
                  decentro_txn_id: SFHSFEKNFSOEJSF
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                'Success: Incoming funds accepted':
                  value: "{\n  \"is_accepted\": true\n}"
                'Success: Incoming funds rejected':
                  value: "{\n  \"is_accepted\": false\n}"
              schema:
                oneOf:
                - title: 'Success: Incoming funds accepted'
                  type: object
                  properties:
                    is_accepted:
                      type: boolean
                      example: true
                      default: true
                - title: 'Success: Incoming funds rejected'
                  type: object
                  properties:
                    is_accepted:
                      type: boolean
                      example: false
                      default: true
      deprecated: false
      tags:
      - Client
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://docs.decentro.tech/reference
  harvested: '2026-10-22'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.decentro.tech/reference/enach-v3-mandate-execution-callback.md
  - https://docs.decentro.tech/reference/enach-v3-registration-callback.md
  - https://docs.decentro.tech/reference/netbanking-terminal-transaction-status-callbackwebhook.md
  - https://docs.decentro.tech/reference/payments_api-collectionsv3-balancecallback.md
  - https://docs.decentro.tech/reference/payments_api-collectionsv3-statuscallback.md
  - https://docs.decentro.tech/reference/payments_api-payout-transaction-status-callback.md
  - https://docs.decentro.tech/reference/payments_api-pre-deposit-check.md
  - https://docs.decentro.tech/reference/payments_api-settlementsv3-callback.md
  - https://docs.decentro.tech/reference/payments_api-transaction-callbacks.md
  - https://docs.decentro.tech/reference/payments_api-upi-auto-pay-presentation-callback.md
  - https://docs.decentro.tech/reference/payments_api-upi-autopay-registration-callback.md
  - https://docs.decentro.tech/reference/pre-deposit-check-callback-1.md
  - https://docs.decentro.tech/reference/remitter-whitelisting-callback.md
  - https://docs.decentro.tech/reference/upi-autopay-mandate-pre-debit-notification-callback.md
  - https://docs.decentro.tech/reference/virtual_accounts_api-account-balance.md
  merge:
    pages: 15
    deduped: 0
    conflicts_kept_first: 0