v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Mandate Presentation Callback

This callback is triggered by Decentro to the platform when a debit request is executed

post/upi_presentation_status1

Headers

your_custom_header_key_1string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

your_custom_header_key_2string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

Request body

presentation_statusstring

Debit status of the presentation

presentation_status_descriptionstring

Description of the debit status of the presentation. Failure reason will be found here

presentation_sequence_idstring

The presentation sequence ID of the presentation cycle

remaining_representation_attemptsinteger

The number of retry attempts pending for a failed presentation attempt in a given presentation cycle. Max retries: 9

presentation_auth_timestampstring

The user authentication timestamp of presentation collect request in case amount is more than the threshold.

decentro_txn_idstring

The decentro Txn ID of the presentation

callback_attemptinteger

The number of times the callback is attempted

callback_txn_idstring

Callback ID provided by Decentro

consumer_urnstring required

The URN of the entity against which the mandate was registered.

callback_timestampstring

The timestamp of the callback

original_callback_txn_idstring

Original Callback ID. Shared in case of retries only

reference_idstring required

The reference ID passed by the platform at the time of Presentation API. For instant presentations, Reference ID will be mapped to Create Mandate APIs reference_id

bank_reference_numberstring

Reference number for the presentation

npci_txn_idstring

The NPCI txn ID of the presentation.

payer_vpastring

UPI handle against which the funds are deducted.

decentro_mandate_idstring

Unique decentro mandate ID assigned for each mandate.

amountnumber double

Mandate registration amount

amount_rulestring

Amount rule as defined at the time of registration

payer_namestring

Payer name against whom the mandate is registered

payee_namestring

The Name of the of the sub-merchant onboarded account

next_debit_datestring date

Next debit date. Applicable if frequency is not ASPRESENTED

mandate_namestring

Name of the mandate holder as passed during registration

frequencystring

Mandate registration frequency

start_datestring date

Mandate start date

end_datestring date

Mandate end date

rule_typestring

The rule type of the mandate as passed during registration

block_fundboolean

Blocking the funds during the debit presentation. Only true to selceted merchants.

is_revocablestring

The flag denotes whether the end user will be able to revoke a mandate.

last_actionstring

The last action performed on the mandate. Example: CREATE, UPDATE, PAUSE

last_action_timestampstring

The timestamp when the last action of performed on the mandate.

error_keystring

Presentation failure reason bucketing.

error_key_descriptionstring

NPCI error code & reason for failure

Response

200

response_codestring

Example response

{
  "response_code": "CB_S00000"
}