Update Mandate Callbacks
Outgoing Update Mandate From Merchant (Payee Initiated)
Server sends a callback to Merchant to the url configured when mandate is updated. With Callback type as MERCHANT_OUTGOING_UPDATE_MANDATE.
Incoming Update Mandate For Merchant (Payer Initiated)
Server sends a callback to Merchant to the url configured when an mandate update/revoke request is received. With Callback type as MERCHANT_INCOMING_UPDATE_MANDATE.
Scroll inside to view more
|
Parameter
|
Description
|
Type
|
|---|---|---|
amount
| Amount of Mandate. Numeric string with two decimals.
| Mandatory
|
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.
| Mandatory
|
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.
| Mandatory
|
expiry
| Timestamp until which create mandate request is valid. It will be present only when payee has initiated the mandate.
| Mandatory
|
gatewayMandateId
| upiRequestId passed in the request.
| Mandatory
|
gatewayReferenceId
| Customer reference number (rrn).
| Mandatory
|
gatewayResponseCode
| Response code returned by gateway for the mandate.
| Mandatory
|
gatewayResponseMessage
| Response message returned by gateway for the mandate.
| Mandatory
|
gatewayResponseStatus
| Response status returned by gateway.
| Mandatory
|
initiatedBy
| Describes whether PAYER or PAYEE has initiated the mandate.
| Mandatory
|
mandateName
| Name of the mandate.
| Mandatory
|
mandateTimestamp
| Timestamp of when the mandate request was attempted.
| Mandatory
|
mandateType
| Denotes the type of mandate operation. Values can be UPDATE/REVOKE.
| Mandatory
|
merchantChannelId
| Unique id for the channel via which request is made.
| Mandatory
|
merchantId
| Unique id for merchant.
| Mandatory
|
merchantRequestId
| Request id used for the mandate. It is merchantRequestId that is passed during initiation of mandate request.
| Mandatory
|
orgMandateId
| Refers to upiRequestId used during creation of mandate.
| Mandatory
|
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.
| Mandatory
|
payeeVpa
| Vpa of the payee.
| Mandatory
|
payerName
| Name of the Payer involved in mandate.
| Mandatory
|
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.
| Mandatory
|
payerVpa
| Vpa of the payer.
| Mandatory
|
recurrencePattern
| Recurrence Pattern for Mandate. Possible values are ONETIME, DAILY, WEEKLY, FORTNIGHTLY,MONTHLY, BIMONTHLY, QUARTERLY, HALFYEARLY, YEARLY, ASPRESENTED
| Mandatory
|
recurrenceRule
| Recurrence Rule for Mandate. Possible values are ON, BEFORE, AFTER. It is not present if recurrencePattern is ONETIME, DAILY or ASPRESENTED.
| Conditional
|
recurrencValue
| 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.
| Conditional
|
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.
| Mandatory
|
remarks
| Any mandate summary
| Mandatory
|
role
| Role of the customer for this mandate. PAYER,PAYEE
| Mandatory
|
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.
| Mandatory
|
transactionType
| Type of Mandate Creation
| Mandatory
|
type
| Event type of the callback
| Mandatory
|
umn
| Vpa used for execution of mandate.
| Mandatory
|
validityEnd Date
| until which mandate can be executed.
| Mandatory
|
validityStart
| Date after which mandate can be executed.
| Mandatory
|
udfParameters
| Stringified json for udf parameters. It will be present only if passed during web update API request.
| Optional
|
- Have questions?
- Need help? Contact support
- LLM? Read llms.txt
