Penny Drop

post

https://uat1.billdesk.com/u2/pgauth/ve1_2/accountvalidation

This API facilitates account validation with pennydrop

Body Params

mercid

string

^[A-Za-z0-9]{1,10}$

Unique identifier as defined by BillDesk for each merchant

currency

string

ISO currency of the transaction amount, for INR this value will be 356

bankid

string

^[A-Za-z0-9]{1,10}$

BillDesk defined unique identifier for acquirer
Mandatory for Upi and Netbanking flows

itemcode

string

^[A-Za-z0-9]{1,20}$

Itemcode value as provided by BillDesk, with a default value DIRECT

additional_info

object

Array of 7 additional_info values that can be attached to
the transaction.
Note: Merchant is advised to not pass customer PII
information in additional info fields.

orderid

string

^[-/~A-Za-z0-9\_ \:.,#@!\\*\\+]{1,120}$

Unique ID generated by the merchant for each request

payment_method

string

enum

Represents the method of payment, and can take the following values - card, netbanking, wallet, upi, eft, bankaccount, cashcard, cardless (non-card emi option)
The associated object will also be provided in the request.

Allowed:

bank_account

object

customer

object

device

object

Device Object

Headers

BD-Traceid

string

required

BD-TraceID is a unique identifier passed by the merchant to ensure request idempotency. Requests with identical BD-TraceID within a 24 hour window would fail.

BD-Timestamp

string

required

Request timestamp to identify date and time of origin of request. Example, a value of BD-Timestamp 20210113180403 identifies the request to have originated on 13th January 2021 at 06:04:03 PM.

Response

200OK