EnKash Developer Portal
Home
Home
Login
  1. UPI Autopay
  • Back to home
  • APIs - Payment Gateway
  • Authorization
    • Generate Authorization Token
    • Payment Modes Details
  • Order
    • UPI Intent Links
    • Get Dynamic UPI QR
    • Create Order
    • Get Order Status
    • Get Order By Merchant Order Id
    • Get BNPL Payment Methods
    • Search Order
  • Payment
    • Get Transaction Status
    • Submit Payment Request
    • Payment Notify Request
    • Verify UPI VPA
    • Validate OTP
    • Get UPI Transaction Status
    • Resend OTP
    • Search Transaction
  • Refund
    • Refund
    • Get Refund Transaction Status
    • Refund Webhook Request
  • Settlement
    • Get Settlement Payout By ID
    • Search Settlement Payouts
  • Split Settlement
    • Get All Split Settlement Account
    • Deactivate Split Settlement Account
    • Submit Payment with Split Details
    • Activate Split Settlement Account
    • Edit Or Deferred Split Settlement
    • Create Split Settlement Account
    • Update Split Settlement Account
    • Get IntentLink/QrCode with Split details
  • E-Commerce Plugins
  • UPI QR
    • Create UPI QR
    • Get UPI QR
    • Search UPI QR
    • Create Customer
    • Search Customer
    • Cancel UPI QR
  • UPI Autopay
    • Mocking & Simulator (UAT)
    • Create UPI Mandate
      POST
    • Update UPI Mandate
      PATCH
    • Revoke UPI Mandate
      PATCH
    • Get UPI Mandate
      GET
    • UPI Mandate Callback
      POST
    • Mandate Pre-debit Notification
      POST
    • Execute Mandate Debit
      POST
    • Mandate Debit Callback
      POST
  • Payment Links
    • Payment Link APIs
    • Create Payment Link
    • Webhook Request
    • Get Payment Link Details
    • Delete Payment Link
  • E-Collect
    • Create Virtual Account
    • View Virtual Account by Id
    • Update Virtual Account
    • View Virtual Account by Account Number
    • Search Virtual Account
    • Search Transactions
    • View Virtual Account by Customer Reference Id
  1. UPI Autopay

Mocking & Simulator (UAT)

Testing without a live bank (mock mode)#

1. Auto-approve/reject by VPA#

Payer VPAResult
user@successACTIVE
user@failREJECTED
Create mandate with one of these VPAs → wait 1–2 min → webhook fires with the result.

2. Execute amount rule#

AmountResult
>= 100SUCCESS
< 100FAILED
Mock UMN format: MOCK-UMN-<20 random chars>.

3. Simulator UI (no VPA / CHECKOUT flow)#

Base URL: https://checkout-uat-v2.enkash.in/v1/upi-autopay-simulator/{umn}
Returned in paymentDetail.checkoutUrl when creating with mandateCreationType = CHECKOUT (no payer VPA).
Open the link, then click Approve or Reject.
APPROVE → ACTIVE
REJECT → REJECTED

4. Happy path#

1.
**API Create UPI Mandate ** with payer.vpa = user@success, a unique referenceId, and a valid firstDebitAmount (e.g. 1 with MAX).
2.
Wait for webhook or API Get status (enquiry) → ACTIVE (1–2 min).
3.
API Notify Mandate with amount >= 100 (needed before executing).
4.
API Execute UPI Mandate with amount >= 100 → SUCCESS + webhook.

5. Reject path#

1.
API Create with payer.vpa = user@fail.
2.
Wait for webhook or API Get status (enquiry) → REJECTED.
3.
Don't notify/execute this mandate — create a new one to retry.

6. Simulator approve path#

1.
API Create with mandateCreationType = CHECKOUT (no VPA).
2.
Open the returned simulator link.
3.
Click Approve → webhook fires ACTIVE.
4.
Continue with API Notify → API Execute as in the happy path.
Modified at 2026-07-24 10:29:28
Previous
UPI Autopay
Next
Create UPI Mandate
Built with