HDFC Bank Vendor Payment Integration

Go to the Apps menu in Odoo.

Remove the Apps filter and search for HDFC Vendor Payment Integration.

Click Install.

HDFC Officer (User-Level Permissions)

Assign this role to users responsible for handling vendor payments through the HDFC Bank integration module. An HDFC Officer can:

• Access HDFC Vendor Payment menus.

HDFC Officer Level Permission

Once the user is assigned the HDFC Officer access level and the HDFC Journal option is enabled, additional configuration tabs become visible inside the journal. These include HDFC Account Settings and HDFC API Settings, allowing the officer to manage bank account details, API configuration, and payment integration settings directly from the journal form.

HDFC Account Settings

Under the HDFC Account Settings tab, you can configure all essential credentials required for establishing a secure connection between Odoo and HDFC Bank’s Vendor Payment API. These settings are only visible to users who have been assigned the HDFC Officer permission level.

The following fields must be configured:

• HDFC Client ID → The unique client identifier provided by HDFC for API access.
• HDFC Client Secret → A secure secret key used for authentication. Keep this confidential.
• HDFC Client Scope → Scope parameter required for generating API tokens.
• HDFC API Login ID → Login ID provided by the bank for API authentication.
• HDFC GCIF Code → The Global Customer Identification File code linked to your corporate account.
• Debit Account Number → The bank account number from which vendor payments will be processed.
• Business Product Code → Product code defined by HDFC for vendor payment transactions.
• HDFC BENE Type → Beneficiary type code required by the HDFC payment API.

All these credentials must match the details shared by HDFC during onboarding. Once configured correctly, Odoo will be able to authenticate with HDFC, initiate vendor payments, and retrieve status updates securely.

Onboarding & App Creation

Follow the steps below on the HDFC UAT Developer Portal:

UAT URL: https://developer-uat.hdfcbank.com:8443/

Steps

1. Click on Launchpad.
2. Click Create App.
3. Fill all mandatory fields and add your Public IP.
4. App Name → Enter any unique project name.
5. Scope → Provided by HDFC.
6. API Product → Search & add "Corppay Initiate Payment & Inquiry-v1".
7. Upload SSL Certificate files (Root, Leaf & Intermediate .cer).
8. Save and share the screenshot with HDFC for approval.

HDFC API Settings → Certificates and Keys

The HDFC API Settings tab contains all the required certificates and keys needed to establish secure encrypted communication with HDFC’s Vendor Payment API. These credentials are mandatory for signing, encrypting, and validating all payment-related requests sent from Odoo to HDFC.

The section is divided into two major parts:

1. Client Certificate and Key

• Client Certificate → The SSL certificate issued to your organization by HDFC.
• Client Private Key Certificate → The private key used to digitally sign outgoing API requests.
• Client Public Key Certificate → The public key corresponding to the private key, used by HDFC for validation.

These certificates ensure that all communication between Odoo and HDFC is authenticated and encrypted. Upload the certificates exactly as provided by HDFC Bank.

2. HDFC Key

• HDFC Public Key Certificate → Used by Odoo to decrypt responses sent from HDFC’s API.

This certificate must be uploaded as shared by HDFC during onboarding. Without this key, Odoo cannot verify the authenticity of responses received from the bank.

Certificate Preparation

HDFC Provides:

• Root certificate
• Intermediate certificate
• Public key

Client Provides:

• SSL Client certificate (Leaf)

Convert all certificates to .cer format if required before uploading.

Vendor Bank Account Configuration

Under the vendor’s Invoicing tab, you can add or manage the vendor’s bank accounts. These bank accounts are required for processing payments through the HDFC integration. After adding a bank account, it appears in the Banks list.

Clicking on the bank account entry opens the detailed bank master wizard, where you can verify the bank name, identifier code, and address.

Vendor Bank Account Details

After selecting a bank account, you can configure key beneficiary details such as: Account Number, Account Holder Name, Bank, IFSC/SWIFT code, and flags like Send Money and Trusted.

From this screen, you can also click on the linked Bank entry, which opens the Bank Master Wizard shown above, allowing you to update bank name, identifier code, and branch address.

Vendor Bank Details → Bank Master Wizard

When you click on the Bank linked to a vendor's bank account, a new wizard opens allowing you to review and update the master bank information associated with that account. This wizard contains essential bank details that are used for verifying and correctly mapping the vendor's bank during HDFC payment processing.

The wizard displays the following key fields:

• Name → The official name of the bank (e.g., HDFC BANK).
• Bank Identifier Code → A unique identifier such as IFSC or SWIFT, depending on the bank's location and payment requirement.
• Intermediary Bank? → Indicates if an intermediary bank is involved in routing the payment.
• Bank Address → The registered address of the bank branch. This includes details such as street, city, and zip code.
• Contact Information → Phone number and email address of the bank (if available).

These details ensure that vendor payments are routed accurately during HDFC API communication. You can update and save the information directly from this wizard.

Vendor Bill Payment → HDFC Payment Wizard

When you click the Pay button on a vendor bill, the system opens the Payment Wizard, where you can initiate an HDFC bank payment directly from Odoo using your configured HDFC API integration.

The wizard displays all key payment details required to process the vendor payment:

• Journal → Shows the HDFC Bank journal that will be used to execute the payment.
• Payment Method → Indicates that the payment will be processed as a manual payment through the HDFC API.
• Bank Transfer Type → Allows you to select the transfer mode such as:
  • NEFT
  • RTGS
  • IMPS
  • Intra Bank Transfer
  The available options depend on your HDFC account and vendor bank type.
• Recipient Bank Account → The vendor's saved bank account that will receive the payment. Only "Trusted" bank accounts appear for safety and compliance.
• Amount → The amount payable for the selected vendor bill.
• Payment Date Allow only current date. Future dates and past dates are not allowed for HDFC payment processing. .
• Memo → Reference or narration that will be sent to HDFC and also appear inside Odoo.

After verifying all details, click the Create HDFC Payment button. This will securely send the payment request to HDFC using encrypted API communication.

Once submitted, the system automatically retrieves and updates the payment status such as: Submitted, Accepted, Processed, Completed, or Rejected.

Vendor Payment → HDFC Payment Initiation Screen

After creating a vendor payment (Customer Payment form in Odoo), users can initiate the HDFC Bank payment directly using the Payment Initiate button. This opens the full HDFC payment interface where transaction details are configured before sending the payment request to the bank.

Main Fields in the Payment Form

• Journal → The selected HDFC Bank journal that will be used for processing the payment through the HDFC API.
• Payment Type → Indicates whether the transaction is:
  • Send → For vendor payments (outgoing)
  • Receive → For recording incoming payments
  The HDFC integration only processes Send transactions.
• Customer / Vendor → The partner for whom the payment is being made.
• Amount → The payment amount that will be transferred from your HDFC bank account.
• Date Allow only current date. Future dates and past dates are not allowed for HDFC payment processing.
• Memo → A reference or narration that will appear in the HDFC transaction and in Odoo.

HDFC Transfer Configuration

The right-hand section contains the specific HDFC transfer configuration fields:

• Bank Transfer Type → Select the mode of transfer supported by HDFC:
  • NEFT
  • RTGS
  • IMPS
  • Intra Bank Transfer
  These options are dynamically loaded based on the bank setup.
• Payment Method → Displays the payment method used by the HDFC integration.
• Company Bank Account → The HDFC bank account (company-side) from which the payment will be deducted.

HDFC Response & Status Tracking

At the bottom, the HDFC Status section shows all live transaction tracking fields:

• HDFC Transaction Reference → Bank reference number generated by HDFC.
• HDFC/Odoo Transaction Reference → Unique internal reference created for auditing.
• HDFC Response Details → Complete response message returned by HDFC API.

Initiating the Payment

Once all details are filled in, click the Payment Initiate button at the top to securely send the payment request to the HDFC Bank API.

The system automatically updates the payment status, showing real-time updates such as: Submitted, Accepted, Processed, Completed, or Rejected.

HDFC Payment Enquiry

After initiating a vendor payment through HDFC, users can verify the real-time status of the transaction using the Payment Enquiry button available on the payment form. This feature communicates directly with the HDFC Bank API and fetches the most recent status of the transaction.

Overview of the Payment Enquiry Page

When the enquiry is performed, Odoo displays a detailed status page containing:

• Journal → The HDFC Bank journal used for processing the payment.
• Bank Transfer Type → NEFT, RTGS, IMPS, or Intra Bank Transfer.
• Payment Method → The payment mode linked with HDFC integration.
• Company Bank Account → The company's HDFC bank account (trusted) used for the transfer.

HDFC Status Panel

The HDFC Status panel displays multiple fields returned by the HDFC API, providing complete transparency into the payment lifecycle. This includes:

• HDFC Transaction Reference → Bank-generated ID for the transaction.
• Status → Current transaction status (e.g., RA, PA, Success, Rejected).
• Status Category → Classification of the transaction outcome.
• Bank Response Details → Technical response fields sent by HDFC.
• Initiation Time → When HDFC received the transaction.
• Maker & Checker Information → Approver/validator data from HDFC workflow.
• ODDO Fields → Internal mapping and HDFC audit details.

Full API Response Table

Below the main payment details, a complete field-by-field response table is shown. This table includes every key-value pair returned by HDFC, such as:

This table ensures complete transparency, helping the accounts team verify, audit, and troubleshoot payment transactions directly from Odoo without logging into the HDFC portal.

HDFC Payment Status Update

Once the payment is processed by HDFC, the vendor payment record in Odoo automatically updates to the Paid state. The system retrieves the latest status through the Payment Inquiry API and displays all HDFC response details on the payment form.

The chatter also logs an automated message such as "Payment Approved From HDFC" along with the date and time, providing a clear audit trail of the transaction lifecycle.

The HDFC Status tab shows complete information including transaction reference, status code, action, bank transfer type, and raw API response received from HDFC.