PhonePe Payment Gateway Python SDK

Warnings

• breaking Official PhonePe SDK is NOT on PyPI. 'pip install phonepe_sdk' alone fails. Must use --index-url pointing to PhonePe's private registry.
  Fix: pip install --index-url https://phonepe.mycloudrepo.io/public/repositories/phonepe-pg-sdk-python --extra-index-url https://pypi.org/simple phonepe_sdk
• breaking 'phonepe' on PyPI (1.0.1) is a community package using old PhonePe v1 API — NOT the official SDK. Using it risks API deprecation and lacks official support.
  Fix: Use official phonepe_sdk from PhonePe's registry, not 'pip install phonepe' from PyPI.
• breaking StandardCheckoutClient must be initialized ONLY ONCE per application. Reinitializing raises PhonePeException.
  Fix: Initialize at app startup as a singleton. Use dependency injection or module-level variable.
• breaking Amount is in paise (1 INR = 100 paise) — same as Razorpay. 500 INR = 50000 paise. Passing rupees directly will undercharge.
  Fix: amount_in_paise = amount_in_inr * 100
• gotcha Status check after payment is MANDATORY. PhonePe docs require polling get_order_status() after redirect — do not rely on redirect callback alone.
  Fix: Always call client.get_order_status(merchant_order_id=order_id) after redirect to confirm payment state.
• gotcha SANDBOX uses test credentials from PhonePe merchant dashboard. Sandbox and Production have different client_id/secret pairs.
  Fix: Use Env.SANDBOX with sandbox credentials for testing. Switch to Env.PRODUCTION with live credentials for deployment.

Install

• pip install --index-url https://phonepe.mycloudrepo.io/public/repositories/phonepe-pg-sdk-python --extra-index-url https://pypi.org/simple phonepe_sdk Python (official — from PhonePe registry, NOT PyPI)

Imports

• StandardCheckoutClient

  from phonepe.sdk.pg.payments.v2.standard_checkout_client import StandardCheckoutClient
  from phonepe.sdk.pg.payments.v2.models.request.standard_checkout_pay_request import StandardCheckoutPayRequest
  from phonepe.sdk.pg.env import Env
  import uuid
  
  # Initialize ONCE — reinitializing raises PhonePeException
  client = StandardCheckoutClient(
      client_id='<client_id>',
      client_secret='<client_secret>',
      client_version=1,
      env=Env.SANDBOX  # or Env.PRODUCTION
  )
  
  # Create payment
  order_id = str(uuid.uuid4())
  request = StandardCheckoutPayRequest.build_request(
      merchant_order_id=order_id,
      amount=10000,  # 100 INR in paise
      redirect_url='https://yourapp.com/callback'
  )
  response = client.pay(request)
  print(response.redirect_url)  # redirect user here

  Official SDK is NOT on PyPI. 'pip install phonepe' installs community wrapper using old v1 API. Official install requires --index-url flag pointing to PhonePe's registry.

Quickstart

PhonePe Python SDK — payment creation and status check.

# Install from PhonePe registry (NOT PyPI):
# pip install --index-url https://phonepe.mycloudrepo.io/public/repositories/phonepe-pg-sdk-python --extra-index-url https://pypi.org/simple phonepe_sdk

from phonepe.sdk.pg.payments.v2.standard_checkout_client import StandardCheckoutClient
from phonepe.sdk.pg.payments.v2.models.request.standard_checkout_pay_request import StandardCheckoutPayRequest
from phonepe.sdk.pg.env import Env
import uuid

# Initialize once at app startup
client = StandardCheckoutClient(
    client_id='<client_id>',       # from PhonePe dashboard
    client_secret='<client_secret>',
    client_version=1,
    env=Env.SANDBOX
)

# Create payment
order_id = str(uuid.uuid4())
request = StandardCheckoutPayRequest.build_request(
    merchant_order_id=order_id,
    amount=50000,  # 500 INR in paise
    redirect_url=f'https://yourapp.com/callback?order_id={order_id}'
)
response = client.pay(request)

# Redirect user to response.redirect_url
print('Redirect to:', response.redirect_url)

# After redirect, check status (mandatory)
status = client.get_order_status(merchant_order_id=order_id)
print('Payment state:', status.state)  # COMPLETED, FAILED, PENDING