Incoming Create Mandate For Customer
Server sends a callback to the customer (PAYER/PAYEE) to the url configured when mandate is created. This callback is sent in the following two cases.
1) It is sent to Payer when a Payer approves the mandate request from Payee and the final response of mandate creation is received from NPCI. It is sent when Payer approves the mandate and not when Payer Declines the mandate.
2) It is sent to Payee when a Payer creates a mandate and final status of mandate creation is received from NPCI.
Scroll inside to view more
|
Parameter
|
Description
|
|---|---|
amount
| Amount of Mandate. Numeric string with two decimals.
|
amountRule
| Rule on Mandate Amount. If amountRule is MAX, then mandate can be executed for amount less than or equal to the passed amount . If amountRule is EXACT, then mandate should always be executed for the same amount.
|
bankAccountUniqueId
| Unique id for the bank account to be linked
|
blockFund
| Denotes whether customer's fund should be blocked or not. For Onetime mandate, value can be true or false and for recurring mandate it is always false.
|
expiry (optional)
| Timestamp until which create mandate request is valid. It will be present only when payee has initiated the mandate.
|
gatewayMandateId
| upiRequestId passed in the request.
|
gatewayReferenceId
| Customer reference number (rrn).
|
gatewayResponseCode
| Response code returned by gateway for the mandate.
|
gatewayResponseMessage
| Response message returned by gateway for the mandate.
|
gatewayResponseStatus
| Response status returned by gateway.
|
initiatedBy
| Describes whether PAYER or PAYEE has initiated the mandate.
|
mandateApprovalTimestamp Optional
| Time instant at which create mandate request was approved. Only present if mandate was initiatedBy Payee. Timestamp in YYYY-MM-DDTHH:MM:SS+05:30 format.
|
mandateName
| Name of the mandate.
|
mandateTimestamp
| Timestamp of when the mandate request was attempted. Timestamp in YYYY-MM-DDTHH:MM:SS+05:30 format.
|
merchantChannelId
| Unique id for the channel via which request is made.
|
merchantCustomerId
| Merchant generated unique id for customer.
|
merchantId
| Unique id for merchant.
|
merchantRequestId (optional)
| Request id used for the mandate. It will be merchantRequestId that is passed during approve mandate if mandate is initiated by Payee else it will be refId that is received from NPCI for Payer initiated mandate. It will not be present if gatewayResponseStatus is expired.
|
orgMandateId
| Refers to upiRequestId used during creation of mandate.
|
payeeMcc
| Merchant Category Code of the payee merchant. If Payee is a customer it will be "0000" else it will be a 4 digit numeric string.
|
payeeName optioanl
| Name of the Payee involved in mandate. It will be present if role is PAYER
|
payeeVpa
| Vpa of the payee.
|
payerName (optional)
| Name of the Payer involved in mandate. It will be present if role is PAYEE
|
payerRevocable
| Denotes whether mandate can be revoke by payer or not. If while requesting mandate Payee passes this flag is true, mandate can be revoked by Payer else it cannot be revoked by Payer. For Onetime mandate, value can be true or false and for recurring mandate it is always true. Default value is true.
|
payerVpa
| Vpa of the payer.
|
recurrencePattern
| Recurrence Pattern for Mandate. Possible values are ONETIME, DAILY, WEEKLY, FORTNIGHTLY,MONTHLY, BIMONTHLY, QUARTERLY, HALFYEARLY, YEARLY, ASPRESENTED
|
recurrenceRule (conditional)
| Recurrence Rule for Mandate. Possible values are ON, BEFORE, AFTER. It is not present if recurrencePattern is ONETIME, DAILY or ASPRESENTED.
|
recurrencValue (conditional)
| Recurrence Value for Mandate. Possible values are 1-31 and depends on the recurrencePattern. It is not present if recurrencePattern is ONETIME, DAILY or ASPRESENTED.
|
refUrl
| Invoice as sent by merchant or reference to the mandate in the form of url. This is a field which is majorly for future purpose and is send by the Payee.
|
remarks
| Any mandate summary
|
role
| Role of the customer for this mandate. PAYER,PAYEE
|
shareToPayee
| Denotes whether mandate should be shared with payee or not. For Onetime mandate, value can be true or false and for recurring mandate it is always true. Default value is true.
|
transactionType
| Type of Mandate Creation
|
type
| Event type of the callback
|
udfParameters (optional)
| Stringified json for udf parameters. It will be present only if passed during Approve mandate API request.
|
umn
| Vpa used for execution of mandate.
|
validityEnd
| Date until which mandate can be executed.
|
validityStart
| Date after which mandate can be executed.
|