API Endpoints

Environment	Endpoint
Staging/ Sandbox	https://staging.api.decentro.tech/v3/payments/transaction/advance/status?decentro_txn_id
Production	https://api.decentro.tech/v3/payments/transaction/advance/status?decentro_txn_id

Response Parameters

Parameters	Description
decentro_txn_id	A unique transaction ID from Decentro for checking the transaction status, refund, etc.
api_status	Status of the API hit. Note that this is not the status of the transaction.
message	API status message. Note that this is not about the status of the transaction.
data.transaction_description	Details regarding the final transaction status.
transaction_status	The final status of the payment transaction
transaction_status_description	The description of the final status of the payment transaction
bank_reference_number	The unique transaction reference number from the bank partner.
npci_txn_id	A unique transaction id generated by NPCI for each transaction.
request_decentro_txn_id	The unique transaction ID shared by Decentro against the API request for generating the payment link, dynamic QR, and the reverse penny drop link or when issuing a Collect or Refund request.
reference_id	The unique ID assigned by your platform against the API request for generating the payment link, dynamic QR, and the reverse penny drop link or when issuing a Collect or Refund request.
error_key	Indicates the entity responsible for failure. Applicable only in case of failed transaction.
transaction_authentication_timestamp	The authentication time stamp when user authenticates via entering the MPIN.
data.transaction_attempt_description	Details regarding all the payment attempts made by user on the transaction.
transaction_attempt_number	The number of transaction attempt done by the user.
attempt_decentro_txn_id	Unique decentro_txn_id for the specific attempt
transaction_status	The final attempt status of the payment transaction.
transaction_status_description	The description of the final attempt status of the payment transaction.
bank_reference_number	The unique transaction reference number from the bank partner.
npci_txn_id	A unique transaction id generated by NPCI for each transaction.
transaction_authentication_timestamp	The authentication time stamp when user authenticates via entering the MPIN.
error_key	Indicates the entity responsible for failure. Applicable only in case of failed transaction. Please refer to the Error Keys section for details.
transaction_attempt_action	The action taken by the merchant against a HOLD transaction attempt or by our system were Auto-refund is enabled.
paid_amount	The amount collected against a Transaction Attempt.
refund_data.reference_id	The reference ID mapped to the refund request
refund_data.decentro_txn_id	A unique transaction ID from Decentro mapped to the refund
refund_status	Status of the refund.
refund_status_description	Message associated with the the refund status.
refund_amount	The amount that will be sent back to the payer.
refund_bank_reference_number	The unique transaction reference number from the bank partner.
refund_npci_txn_id	A unique transaction id generated by NPCI for each transaction.

Response Keys

Response Keys	Message
success_transaction_status_successful	UPI Transaction Status processed successfully.
error_no_transaction_found	This transaction was not found in our system. If there was any debit, it would have already been reversed. Please retry the corresponding initiate payment transaction.
success_transaction_status_pending	UPI Transaction Status processed successfully.
success_transaction_status_failure	UPI Transaction Status processed successfully.
success_transaction_status_expired	UPI Transaction Status processed successfully.
error_provider_error	Error while fetching transaction status from provider.
error_api_access_error	Error while accessing the API.
error_authentication_request	Error while authenticating the request.
error_unauthorized_request	Unauthorized request.
error_plan_not_configured	Plan not configured.
error_plan_not_found	Plan not found.
error_duplicate_transaction	Duplicate transaction found.

Error Keys

Decentro intimates the platform about the error leg i,e where the error has occurred in the transaction using the 'error_key' in the callback payload. Please note that error keys are for the platform's use, and standalone is not recommended for end-user messaging.

Below are the values propagated by Decentro, as well as the associated interpretation.

Error Key	Description
error_at_remitter_bank	The transaction failed due to an issue at the payer's bank, such as breached limits or a frozen account.
error_at_beneficiary_bank	The transaction failed due to an issue at the Decentro's bank partner's end.
error_at_payer_psp	The transaction failed due to an issue at payer PSP, i.e., the UPI app used by the payer to authorize the transaction.
error_at_payee_psp	The transaction failed due to payee PSP, i.e., Decentro's partner bank's end.
error_at_npci	The transaction failed due to an issue at the NPCI level