Pine Labs Payments API Reference

REST APIs for orders, payments, refunds, subscriptions, split settlements, payouts and checkout links — with live request examples in every major language.

Authentication

Authenticate API requests and generate Bearer access tokens using OAuth 2.0 client credentials flow.

Orders

Create payment orders, capture authorized payments, cancel pre-authorized orders, and retrieve order details by ID or merchant reference.

Refunds

Create full or partial refunds against completed payment orders with idempotent request handling.

Settlements

Retrieve settlement reports and details, search by UTR number for bank reconciliation and payout tracking.

Split Settlements

Release held funds to sub-merchants or vendors in marketplace flows, or cancel pending split settlements.

Checkout

Generate hosted checkout page URLs to accept payments without custom frontend integration.

Payment Links

Create shareable payment links, retrieve link details, cancel active links, and resend notifications via SMS or email.

Card Payments

Process credit and debit card payments with OTP authentication, 3D Secure, BIN lookup, and decoupled authorization.

UPI Payments

Process UPI payments via collect requests, intent flows, and QR codes with VPA validation.

NetBanking

Process net banking payments from all major Indian banks with secure redirect flows.

Wallet

Process digital wallet payments including Paytm, PhonePe, Amazon Pay with OTP authentication.

Pay by Points

Verify VPA and check reward points balance to process payments using customer loyalty points.

E-Challans

Create electronic challans for government and institutional fee collection, retrieve challan details and download PDF receipts.

Apple Pay

Authorize Apple Pay payments by processing encrypted payment tokens from Apple Wallet on iOS.

International Payments

Process cross-border card payments in 100+ currencies, compute TCS for LRS remittance, manage invoices and AWB documents for compliance.

Customers

Create customer profiles, update customer information, and retrieve customer details for tokenization and subscriptions.

Tokenization

Generate RBI-compliant card tokens, retrieve service provider tokens, create cryptograms, and manage saved cards for one-click payments.

Payouts

Transfer funds to bank accounts via IMPS, NEFT, or RTGS with support for instant, scheduled, and bulk payouts.

Affordability Suite

Discover EMI offers and bank discounts, validate offer eligibility, check IMEI for device financing, and process affordability payments.

BNPL

Check customer eligibility for Buy Now Pay Later, submit OTP for authentication, and process pay later transactions.

Convenience Fee

Calculate applicable convenience fees and surcharges for different payment methods and transaction amounts.

Payment Option

Verify UPI VPA details and check payment eligibility before initiating transactions.

Brand Wallet

Create brand wallets, validate wallet eligibility, activate/deactivate wallets, check balance, load funds, reset PIN, and view transaction history.

Brand Wallet Payments

Process payments using brand wallet balance and add money via gift cards or UPI for closed-loop payment programs.

Subscriptions - Plans

Create subscription plans with billing frequency and amount, retrieve plan details, update or delete plans.

Subscriptions - Subscriptions

Create recurring payment subscriptions with auto-debit mandates, manage subscription lifecycle including pause, resume, and cancellation.

Subscriptions - Presentations

Submit debit requests against active subscription mandates, send pre-debit notifications, and retry failed collections.

UPI Reserve Pay

Create SBMD-enabled subscriptions to reserve funds in UPI accounts and process debits against blocked amounts.