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

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