Available in🇮🇳 India
An instrument answers two separate questions.
statussays whether Razorpay and the bank or provider have finished setting the instrument up for the account. Razorpay does this once, and it can take days.enabledsays whether customers can pay with it at checkout right now. It is an instant on and off switch that you control.
An instrument that is not activated is never enabled.
2.1 Instrument Statuses
Disabling an instrument that is
in_progress, under_review or needs_clarification returns it to eligible.
2.2 Reason Codes
status_reason appears for an ineligible, rejected or suspended instrument. It is null otherwise. Build logic on status_reason.code, not on the text.
2.3 How Each Instrument Goes Live
What happens when you enable an instrument depends on which of four paths it is on.
The path depends on the instrument:
Handy Tips
- Fetch the payment method for the instrument’s actual path and
estimated_activation_days. The estimate adjusts to the account’s business category. It isnullwhen there is no estimate, or when the instrument needs no onboarding. - Onboarding asks for items such as business details, website policy links or documents, depending on the bank or provider and the business sub-category. Each item appears in
requirements.