Skip to main content

Billdesk

Scope of Integration

Yellow.ai Integration with Billdesk Payment Gateway allows you to create UPI Intent for WA Pay, view payment status and Send UPI notification with the yellow.ai platform.

Use-cases

Following are the use-cases which are currently accommodated in the Integration:

1. Generate UPI Intent

Get the final amount from your cart total and call the Generate UPI Intent action node of integration, get the transaction Id and Intent URI for whatsapp pay api.

Node Input Params:-

Field NameSample InputDescription
Amount*200The amount for the request.
Additional Parametersany varcharadditional_info values that can be attached to the transaction.
Additional Parameters[email protected]additional_info values that can be attached to the transaction.
Additional ParametersSome valueadditional_info values that can be attached to the transaction.

alt_text

Note: To use in app.ym's bot use below function
app.executeIntegrationAction({
"integrationName": "billdesk",
"action": "Generate UPI Intent",
"dynamicParams": {
"amount": 100
}
}).then((res)=>{
console.log("response from action node", res);
app.log(res, '||Response from action node||')
}).catch((err)=>{
console.log("Error in action node",err);
app.log(err, '||Error in action node||')
})
Sample Success Response:
{
"objectid": "transaction",
"transactionid": "X7890477676443",
"orderid": "UPIODR00000004",
"mercid": "BDMERCID",
"transaction_date": "2022-03- 18T11:50:27+05:30",
"amount": "2.00",
"surcharge": "0.00",
"txn_process_type": "collect",
"bankid": "789",
"itemcode": "DIRECT",
"auth_status": "0002",
"transaction_error_code": "TRP0000",
"transaction_error_desc": "Transaction Pending",
"transaction_error_type": "pending",
"payment_method_type": "upi"

2. Generate UPI Collect

The end customer will authorize the transaction via the UPI PSP mobile app. On successful authorisation, BillDesk will receive a callback from the acquirer, and in turn BillDesk will notify the merchant via webhook notification.

Node Input Params:-

Field NameSample InputDescription
Amount*200The amount for the request.
VPA*[email protected]UPI Id of customer
Additional Parametersany varcharadditional_info values that can be attached to the transaction.
Additional Parameters[email protected]additional_info values that can be attached to the transaction.
Additional ParametersSome valueadditional_info values that can be attached to the transaction.
Note: To use in app.ym's bot use below function
app.executeIntegrationAction({
"integrationName": "billdesk",
"action": "Generate UPI Collect",
"dynamicParams": {
"amount": 100,
"vpa":"[email protected]",
"additionalParameters4":"anything"
"additionalParameters5":"anything"
"additionalParameters6":"anything"
}
}).then((res)=>{
console.log("response from action node", res);
app.log(res, '||Response from action node||')
}).catch((err)=>{
console.log("Error in action node",err);
app.log(err, '||Error in action node||')
})
Sample Success Response:
{
"objectid": "transaction",
"transactionid": "X7890477676443",
"orderid": "UPIODR00000004",
"mercid": "BDMERCID",
"transaction_date": "2022-03- 18T11:50:27+05:30",
"amount": "2.00",
"surcharge": "0.00",
"txn_process_type": "collect",
"bankid": "789",
"itemcode": "DIRECT",
"auth_status": "0002",
"transaction_error_code": "TRP0000",
"transaction_error_desc": "Transaction Pending",
"transaction_error_type": "pending",
"payment_method_type": "upi"

Event for receving payment confirmation on bot

Following are the events which are currently accommodated in the Integration:

EventDescription
Billdesk Payment StatusIn case of payments the status can be checked with these details.

Please Activate the Billdesk Payment Status after configuring instamojo credentials at integration page.

Configuration

Configuring the integration with Billdesk is straightforward. Follow the steps defined below to start integrating:

  1. Get the KeyId, Client Id, Merchant Id, Public Key File and API Base URL from Billdesk Team.

  2. Upload your Public Key file in some bucket or server like (AWS-S3, SFTP, etc) and Get the public CDN Url . Note:(CDN URL should be public readable).

  3. Now Go to Integration page and Enter the right value in Billdesk's form to connect the billdesk Integration.

alt_text