upi_inr

Overview

The customer is redirected to a Tazapay-hosted checkout page where they can complete payment using any UPI app. Funds settle instantly to the merchant.

Step 1: Create a Payin

Create a payin with invoice_currency: INR. The payin is created with status requires_payment_method.

curl --request POST \
     --url https://service-sandbox.tazapay.com/v3/payin \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxxxxxXXXXxxxxxxxxxxxxxxxxx' \
     --header 'content-type: application/json' \
     --data '{
  "invoice_currency": "INR",
  "amount": 10000,
  "transaction_description": "Test"
}'

Step 2: Confirm the Payin

Confirm the payin to generate a redirect URL. Status moves to requires_action. Set payment_method_details.type to upi_inr.

curl --request POST \
     --url https://service-sandbox.tazapay.com/v3/payin/pay_cttprok2ukmk385sbfm0/confirm \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxxxxxXXXXxxxxxxxxxxxxxxxxx' \
     --header 'content-type: application/json' \
     --data '{
  "customer_details": {
    "name": "Andrea Lark",
    "email": "andrea@example.com",
    "country": "IN"
  },
  "payment_method_details": {
    "type": "upi_inr"
  }
}'

Combine Steps 1 & 2 into a single API call

Pass all parameters to the Create Payin endpoint along with "confirm": true.

Field	Type	Required	Description
`confirm`	boolean	Yes	Confirms the payin on creation

curl --request POST \
     --url https://service-sandbox.tazapay.com/v3/payin \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxxxxxXXXXxxxxxxxxxxxxxxxxx' \
     --header 'content-type: application/json' \
     --data '{
  "customer_details": {
    "name": "Andrea Lark",
    "email": "andrea@example.com",
    "country": "IN"
  },
  "confirm": true,
  "invoice_currency": "INR",
  "amount": 10000,
  "transaction_description": "test",
  "payment_method_details": {
    "type": "upi_inr"
  }
}'

Step 3: Redirect the Customer

The confirm response includes a redirect_url inside latest_payment_attempt_data. Redirect the customer to this URL to complete payment.

{
  "data": {
    "status": "requires_action",
    "latest_payment_attempt_data": {
      "expires_at": "2025-01-23T08:25:41Z",
      "redirect_url": "https://checkout-sandbox.tazapay.com/single-payment.html?tzid=..."
    }
  }
}

You must redirect the customer to latest_payment_attempt_data.redirect_url to enable payment completion.

Step 4: Handle Post-Payment Events

Tazapay sends webhooks to your configured endpoint.

Event	Description	Next Steps
`payin.succeeded`	Customer paid before expiry	Fulfill the order
`payment_attempt.failed`	URL expired unpaid	Re-confirm the payin to generate a new URL

Testing

Scenario	Action
Simulate success	Click Simulate Success on the `redirect_url` → receives `payin.succeeded`
Simulate failure	Click Simulate Failure on the `redirect_url` → receives `payment_attempt.failed`

Refunds

upi_inr does not support partial refunds. Only full refunds are available.

Via Dashboard
Via API

Refer to the refund guide.

curl --request POST \
     --url https://service-sandbox.tazapay.com/v3/refund \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxxxxxXXXXxxxxxxxxxxxxxxxxx' \
     --header 'content-type: application/json' \
     --data '{
  "payin": "pay_cmiiaamaq0pbt3fkadm0",
  "reason": "Customer Return"
}'

amount and currency are not required for a full refund.

Overview

Payment Methods

Integration

Testing

Post-Payment

Overview

Step 1: Create a Payin

Step 2: Confirm the Payin

Step 3: Redirect the Customer

Step 4: Handle Post-Payment Events

Testing

Refunds

​Overview

​Step 1: Create a Payin

​Step 2: Confirm the Payin

​Step 3: Redirect the Customer

​Step 4: Handle Post-Payment Events

​Testing

​Refunds

Overview

Step 1: Create a Payin

Step 2: Confirm the Payin

Step 3: Redirect the Customer

Step 4: Handle Post-Payment Events

Testing

Refunds