This section describes how to create transaction webhooks for the transactional notifications to be captured at their end. This callback is to be used to capture the notifications of the transactions made via the card network

Type POST

API / webhooks headers

Parameter	Type	Parameter Requirement	Description
X-Consumer-Custom-ID	string (15)	Mandatory	This is the unique key to be shared with the client by Wibmo for the API environment exposure.
clientId	string (15)	Mandatory	This is the Unique ID for the client to be shared by Wibmo.
bankId	Numeric (4)	Mandatory	Unique ID to identify the issuer bank. Wibmo to share. `6060 - in case PayU is the issuer`
entityId	Numeric (4)	Optional	Child corporate/branch entity ID under the client. If not passed, it will default to the client's parent branch.

Request Parameters

Parameter	Type	Parameter Requirement	Description	Sample value
customerId	string (50)	Optional	Unique customer ID for the customer in the Prepaid and client system.	HRM0054454
urn	string (20)	Mandatory	Unique reference number for the customer.	10000333
systemTraceAuditNumber	string (10)	Mandatory	STAN 6-digit unique internal audit number for the issuer.	018663
bin	string (20)	Mandatory	BIN for the card network	484441
transactionCurrency	string (20)	Mandatory	Transaction currency.	INR
currencyCode	string (5)	Mandatory	Currency according to the ISO-4217 country currency code format. E.g. 356 for INR and 840 for USD	356
tid	string (20)	Mandatory	Terminal ID for the payee merchant.	04051004
mcc	string (20)	Mandatory	MCC for the payee merchant.	6011
merchantName	string (50)	Mandatory	Payee merchant name.	SBI CHANDRA LAYOUT BANGALORE KAIN
merchantId	string (20)	Optional	Payee merchant ID	S1NB004051004
network	string (20)	Mandatory	Card network	RUPAY
rrn	string (20)	Mandatory	Transaction retrieval reference number at Prepaid.	202522018663
transactionReferenceNumber	string (50)	Mandatory	Transaction reference number at Prepaid.	202522678746
last4Digits	string (5)	Mandatory	Card’s last 4 digits	5059
transactionStatus	string (20)	Mandatory	Transaction status from the network.	PAYMENT_SUCCESS
transactionType	string (10)	Mandatory	Type of transaction	DR/CR
acquirerId	string (20)	Mandatory	Acquirer ID for the transaction.	00000622018
transactionAmount	string (10)	Mandatory	Transaction amount in implied decimals.	10000
channel	string (20)	Mandatory	Transaction channel.	POS
transactionFee	string (10)	Optional	Fee applied on the transaction from the network, if applicable.	2000
authCode	string (20)	Mandatory	Auth code for the transaction.	678746
transactionDateTime	string (20)	Mandatory	Timestamps in YYYYMMDDHHMMSS with time in 24-hour format.	20240629215049
walletList	List	Optional	List of sub-wallet associated and their balances in implied decimals.	Refer to the sample provided below.

Sample request

{
	"customerId": "HRM0054454",
	"urn": "10000333",
	"systemTraceAuditNumber": "18663",
	"bin": "484441",
	"transactionCurrency": "INR",
	"currencyCode": "356",
	"tid": "4051004",
	"mcc": "6011",
	"merchantName": "SBI CHANDRA LAYOUT BANGALORE KAIN",
	"merchantId": "S1NB004051004",
	"network": "RUPAY",
	"rrn": "202522018663",
	"transactionReferenceNumber": "202522678746",
	"last4Digits": "5059",
	"transactionStatus": "PAYMENT_SUCCESS",
	"transactionType": "DR",
	"acquirerId": "622018",
	"transactionAmount": "10000",
	"channel": "POS",
	"transactionFee": "2000",
	"authCode": "678746",
	"transactionDateTime": "20240629215049",
	"walletList": [
		{
			"walletName": "GENERAL",
			"balance": "10006700",
			"accountNumber": "704030003012653",
			"subWalletId": "204d2e91a41_1"
		},
		{
			"walletName": "subWallet1",
			"balance": "500000",
			"accountNumber": "704030003012654",
			"subWalletId": "204d2e91a41_2"
		}
	]
}

Response codes

Only API acknowledgement will be required for this webhook notification.

HTTP Status Code	HTTP Status Description
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error
503	Service Unavailable