UPI Merchant Stack

Pause Mandate Callback

Server sends a callback to Merchant to the url configured when mandate is paused.

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
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 PAUSE/UNPAUSE.
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 operation. It is merchantRequestId that is passed during initiation of mandate request.
Mandatory
orgMandateId
Refers to upiRequestId used during creation of mandate.
Mandatory
pauseEnd
Date until which mandate is paused
Mandatory
pauseStart
Date from which mandate is paused
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. It will be present if role is PAYEE
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