Network-Based Authorized Transaction Callback Notification

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 CodeHTTP Status Description
200OK
400Bad Request
401Unauthorized
403Forbidden
404Not Found
500Internal Server Error
503Service Unavailable