v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Set Default Split Settlement Rule Configuration

post/v3/banking/manage_default_settlement_configuration

Headers

client_idstring required

Decentro assigned client_id during on boarding.

client_secretstring required

Decentro assigned client_secret during on boarding.

x_on_behalf_offstring

Optional header that allows parent merchant to consume the API on behalf of sub-merchant.The child consumer URN value must be passed here.

Request body

reference_idstring required

A unique ID assigned by clients for every API request.

settlement_typestring

The payment channel against which the settlement must be configured. "UPI_COLLECTION","E_COLLECT","NACH","UPI_AUTOPAY"

virtual_account_numberstring

The virtual account number to be passed here. Mandatory only if the settlement type is "E_COLLECT".

consumer_urnstring

The consumer URN to be passed here. Mandatory only if settlement type is not "E_COLLECT".

default_split_settlement_rule_urnstring required

A URN generated to map the rules of the split against it. The URN passed here will be the default split rule.

Response

200

decentro_txn_idstring

api_statusstring

messagestring

response_keystring

Example response

{
  "decentro_txn_id": "96C55AFDE9FD4BF9AA7CB9E9982569A5",
  "api_status": "SUCCESS",
  "message": "Default Settlement Config saved successfully.",
  "data": {
    "default_split_settlement_urn": "DD31C52176DB4F068C08E7FDBAE2E2CB",
    "default_split_settlement_rule": [
      {
        "percentage": 1,
        "commission_deduction": true,
        "settlement_account_urn": "12341B04125744CAAC39CCD20431D92F"
      }
    ]
  },
  "response_key": "success_default_settlement_config_saved_successfully"
}