Flow Release Notes | Version 3.8.2

Release date: 27th November, 2025

Enach - Enhancement in Supported Banks Check API

This API is used to check supported banks for auth modes
Merchants can now check whether a bank is live for PAN or Customer ID by providing the bank code.
Merchants can also check all supported banks by entering "pan" or "customerid" in the auth_mode field.

{  
  "decentro_txn_id": "8FFF4DE84DF94B1C8194FE8046D5B969",  
  "api_status": "SUCCESS",  
  "message": "Supported methods for bank code fetched successfully",  
  "data": {  
    "aadhaar": "supported",  
    "customer_id": "supported",  
    "debit_card": "supported",  
    "net_banking": "supported",  
    "pan": "supported"  
  },  
  "response_key": "success_bank_code"  
}`

Enach - Introduced New Auth Modes PAN & Customer ID

Decentro has introduced two new authentication modes PAN and Customer ID in addition to the existing Aadhaar, Debit Card, and Net Banking options.
Merchants can now register mandates using pan or Customerid as the authentication mode in the Create Mandate API.

Autopay - Get Mandate Presentation Status update

We have enhanced the GPS (Get Mandate Presentation Status) API to provide clearer and more consistent presentation information to merchants.
A new field remaining_representation_attempts has been added to the GPS API response. Propagated only for failed presentations.
This field indicates how many re-presentations are still available for the mandate (decreasing by 1 after each attempt). This value is now aligned with what is already sent in the presentation callback.
If reference_id is used to fetch the presentation status, then status of that particular attempt will be returned.
If presentation_sequence_id is used to fetch the presentation status, then status of the latest attempt will be returned.

{  
  "decentro_txn_id": "0EB79BF1C5D048B9834846BEFF93F77A",  
  "api_status": "SUCCESS",  
  "message": "Presentation status retrieved successfully",  
  "data": {  
    "presentation_detail": {  
      "status": "FAILED",  
      "status_description": "Mandate presentation is failed",  
      "bank_reference_number": "529513136006",  
      "npci_txn_id": "YES3e067718a64c488088b7b09b9c502963",  
      "transaction_authentication_timestamp": "Oct 22, 2025 01:27:43 PM",  
      "remaining_representation_attempts": 0 //New param  
    }  
  },  
  "response_key": "success_presentation_status_fetched"  
}

Autopay - Introducing Pre-Debit Notification Status Check API

This API is used to check status of the PDNs
This API allows merchants to check the status of a Pre-Debit Notification (PDN) using either:
- presentation_sequence_id
- reference_id

Status propagated:

SUCCESS
FAILURE

curl --location --globoff '{{url}}/v3/payments/upi/autopay/notification/status?presentation_sequence_id=&reference_id='  
--header 'client_id: {{client_id}}'  
--header 'client_secret: {{client_secret}}'

{  
  "decentro_txn_id": "6AD2CC1C94214DDFB273113B47607F01",  
  "api_status": "SUCCESS",  
  "message": "Pre-Debit Notification status retrieved successfully",  
  "data": {  
    "notification_detail": {  
      "notification_status": "SUCCESS",  
      "presentation_sequence_id": "DFN-E8A948E5AE5E4AED986D96630C1D241C-00003",  
      "debit_date": "Mar 21, 2025 12:00:00 AM",  
      "decentro_mandate_id": "E8A948E5AE5E4AED986D96630C1D241C",  
      "amount": "1.0000"  
    }  
  },  
  "response_key": "success_pre_debit_notification_status_fetched"  
}

{  
  "decentro_txn_id": "E4FFE0E9E92A4A8EB3757E87504CBB5E",  
  "api_status": "SUCCESS",  
  "message": "Pre-Debit Notification status retrieved successfully",  
  "data": {  
    "notification_detail": {  
      "notification_status": "FAILED",  
      "presentation_sequence_id": "DFN-0DF47BA734314E1F8A6B35A7C0B6A675-00001",  
      "decentro_mandate_id": "0DF47BA734314E1F8A6B35A7C0B6A675",  
      "amount": "1.0000"  
    }  
  },  
  "response_key": "success_pre_debit_notification_status_fetched"  
}

Autopay - Pre-Debit Notification Callback

PDN API will now accept the callback subscriber data from merchants.

{  
    "reference_id": "{{$randomUUID}}",  
    "decentro_mandate_id": "4FA267DE0B764517BD39A174861BCAF2",  
    "amount": 14999,  
    "debit_date": "2025-10-25",  
        "mandate_pdn_callback_subscriber_data": {  
        "url": "<https://webhook.site/XXXXXX1c5182a">,  
        "method": "POST",  
        "headers": {  
            "content-type": "application/json"  
        }  
    }  
}

{  
  "callback_attempt": 1,  
  "callback_txn_id": "11C00079A0B140229CFB0FA37865C225",  
  "consumer_urn": "67EAB0611FC142E4859EF11267C25C31",  
  "original_callback_txn_id": "5B92128C1D6A449CAC76EBF75BED472B",  
  "callback_timestamp": "2025-11-26 13:55:56",  
  "bank_reference_number": "334736535451",  
  "amount": "200.0000",  
  "debit_date": "2025-11-28 00:00:00",  
  "decentro_txn_id": "59DD7A63138148F8A42B3E6EEB6B2AA6",  
  "notification_status": "FAILED",  
  "reference_id": "f5dcaed0-a58b-458e-96ca-251eeb8ba2f4",  
  "decentro_mandate_id": "E2C6A018D4C0473DAFEFF7F6C678E42F",  
  "error_key": "error_at_payer_psp",  
  "status_description": "Transaction not permitted by payer's PSP."  
}

{  
  "callback_attempt": 3,  
  "callback_txn_id": "EB6A17A9A81342F4AB6BB850E1109161",  
  "consumer_urn": "67EAB0611FC142E4859EF11267C25C31",  
  "original_callback_txn_id": "E09C297E45D14D95AB21FBB09A558B45",  
  "callback_timestamp": "2025-11-26 13:57:28",  
  "npci_txn_id": "YESc37d2cf00379492ba535cebeeb634f64",  
  "bank_reference_number": "802970019720",  
  "amount": "100",  
  "debit_date": "2025-11-28 00:00:00",  
  "decentro_txn_id": "4004F182A0524B6DB31F93100DA6794A",  
  "notification_status": "SUCCESS",  
  "reference_id": "45025fa1-67b0-441f-b364-33eb3b389e5c",  
  "decentro_mandate_id": "E2C6A018D4C0473DAFEFF7F6C678E42F",  
  "presentation_sequence_id": "DFN-E2C6A018D4C0473DAFEFF7F6C678E42F-00002"  
}