Sign in

v1

latestOpenAPI 3.0.02026-07-2431146358.7 KB
Transaction

Update Transaction

This endpoint authorizes an existing transaction.

post/payments/ve1_2/transactions/update

Headers

BD-Traceidstring required
Example:20201203182838

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-Timestampstring required
Example:20201203182838

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.

Content-Typestring required
Example:application/json

Request Content-Type to take the values application/jose

Acceptstring required
Example:application/jose

Accept Response Content-Type to take the values application/jose

Request body

mercidstring required

Unique identifier as defined by BillDesk for each merchant

transactionidstring required

Unique transactionid created by BillDesk

payment_method_type'card' | 'netbanking' | 'upi' | 'eft' | 'cardless' | 'bankaccount' required

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.

mandateidstring

Unique mandateid created by BillDesk

Example request

{
  "mercid": "BDMERCID",
  "transactionid": "U4560001099939",
  "response_parameters": {
    "cres": "eJytmFmvo8iSgN/5Fa26j 1Y3qxdariMlO9hgsy8vIwyYfTGLWX7 94HP6VFXX1Ghujy7S0UmCzMiIzIgv0 nk0kjaKGD0KhjZ6O8pR1XyXA364Xvl 88vF+ivl/jvm6mfrze/W+TZS3g",
    "AccuResponseCode": "ACCU000 ",
    "session": "X4440639244491",
    "AccuGuid": "a13df076-5c82-4fbf-aa5c-be11e9847e9a",
    "AccuRequestId": "MGI2ZTE2M2RjYzJjNTBhMDlkMzA1OTc2NmU3OTBjOTdjNjk3NjA5MDdmY2RlMDI1MTA1MDBjOTYyMzMyODNjNg==\""
  },
  "card": {
    "number": "4242420000001234",
    "expiry_month": "02",
    "expiry_year": "2029",
    "holder_name": "John Doe",
    "cvv": "123"
  },
  "mandateid": "MA19E400049927"
}

Response

OK

objectid'transaction' | 'authentication' | 'mandate' | 'invoice' | 'cardaccount' | 'validatevpa' | 'dispute' | 'settlement' | 'altid' | 'mandate_token' | 'accountvalidation'

String representing the object's type. Objects of the same type share the same value.

mercidstring

Unique identifier as defined by BillDesk for each merchant

transactionidstring

Unique transactionid created by BillDesk

orderidstring

Unique ID generated by the merchant for each request

transaction_datestring date-time

BillDesk transaction date and time in YYYY-MM-DDThh:mm:ssTZD format

amountstring

Transaction amount in two decimals, eg. 299.28

surchargestring

Customer surcharge in two decimals applied to the transaction amount, if any

discountstring

Customer discount in two decimals applied to the transaction amount, if any

charge_amountstring

Total charge to the customer

currencystring

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

rustring

Merchants URL where the customer will be redirected after a transaction is completed

txn_process_type'y3ds' | '3ds' | 'collect' | 'intent' | 'qr' | 'nb' | 'eft' | 'si'

Indicates transaction processing type, will be the following values: AFA payment • card - 3ds or y3ds or 3ds_redirect • upi – collect, qr or intent • netbanking – nb • eft - offline Recurring payment • card, upi, bankaccount – si

bankidstring

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

itemcodestring

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

payment_method_type'card' | 'netbanking' | 'upi' | 'eft' | 'cardless' | 'bankaccount'

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.

auth_status'0300' | '0002' | '0399'

Represents the authorization status of the transaction with the following possible values: • 0300 - transaction is successful • 0002 - transaction is pending for authorization • 0399 - transaction failed

transaction_error_codestring

Represents the error code for the response

transaction_error_descstring

Represents the error description for the response

transaction_error_typestring

Represents the error type for the response

ecistring

Authentication ECI indicator, as per the 3ds protocol (for V, M, D, A cards)

authcodestring

Authorization code received from the acquirer for a successfully authorized card transaction

bank_ref_nostring

Transaction reference number generated by bank or acquirer

payment_categorystring

Payment Category Code, defines the transaction belonging to the payment mode. • 00 - Card Gateway • 01 - Netbanking • 02 - Credit card • 03 - Debit card • 04 - Cash card • 05 - Mobile wallet • 10 - UPI • 11 - Bharat QR • 12 - Loan EMI • 13 - NEFT • 18 - UPI Credit • 19 - ENACH • 20 - CBDC • 21 - UPI Prepaid Wallet • 22 - UPI Credit Line

me_ref_idstring

Unique identifier for a merchant, defined by the acquiring bank as a 6 digit code

Example response

{
  "mercid": "BDMERCID",
  "transactionid": "U4560001099939",
  "orderid": "TEST0000009005",
  "transaction_date": "2023-03-14T15:14:39+05:30",
  "amount": "299.28",
  "ru": "https://www.merchant.com",
  "txn_process_type": "y3ds",
  "bankid": "1HM",
  "itemcode": "DIRECT",
  "card": {
    "type": "debit, credit, prepaid",
    "masked_value": "xxxxxxxxxxxx1001",
    "network": "VISA, MASTER"
  },
  "additional_info": {
    "additional_info1": "Details1",
    "additional_info2": "Details2",
    "additional_info3": "Details3",
    "additional_info4": "Details4",
    "additional_info5": "Details5",
    "additional_info6": "Details6",
    "additional_info7": "Details7"
  },
  "payment_category": "18",
  "me_ref_id": "545963"
}