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 transaction notifications made via the APIs like load and unload.

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)	Mandatory	Unique customer ID for the customer in the Prepaid and client system.	HRM0054454
urn	string (20)	Mandatory	Unique reference number for the customer.	10000333
prepaidTransactionId	string (50)	Mandatory	Unique transaction ID at Prepaid.	128989999921
transactionType	string (10)	Mandatory	Type of transaction.	CR/DR
transactionNarration	string (100)	Optional	Transaction narration, if any.	Test Transaction
transactionAmount	Long	Mandatory	Amount in implied decimals. E.g. INR100 will be 10000	10000
transactionDateTime	string (15)	Mandatory	Timestamps in YYYYMMDDHHMMSS with time in 24-hour format.	20240629215049
transactionStatus	string (10)	Mandatory	Status of the transaction.	Success
additionalInfo	string (100)	Optional	Additional info, if any.	Demo transaction
transactionClosingBalance	Long	Optional	Closing balance of the wallet.	2693300
implId	string (20)	Optional	IMPL ID that is applicable to the transaction. Refer to the IMPL ID section in this document for more info.	O\|70161
implType	string (20)	Optional	IMPL ID type	P2M1_W2A_O_UPI

Sample request

{
	"customerId": "000000000169",
	"urn": "10000333",
	"prepaidTransactionId": "1596725",
	"transactionType": "DR",
	"transactionNarration": "Test transaction",
	"transactionAmount": 5000,
	"transactionDateTime": "20240629215049",
	"transactionStatus": "SUCCESS",
	"additionalInfo": "Demo transaction",
	"transactionClosingBalance": 2693300,
	"implId": "O|70161",
	"implType": "P2M1_W2A_O_UPI"
}

Response codes

Response 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