API Playground

Test Pine Labs API endpoints with real requests. All endpoints are loaded dynamically from the OpenAPI specification.

Authentication

Orders

Refunds

Settlements

Split Settlements

Checkout

Payment Links

Card Payments

UPI Payments

NetBanking

Wallet

Pay by Points

E-Challans

Apple Pay

International Payments

Customers

Tokenization

Payouts

Affordability Suite

BNPL

Convenience Fee

Payment Option

Brand Wallet

Brand Wallet Payments

Subscriptions - Plans

Subscriptions - Subscriptions

Subscriptions - Presentations

UPI Reserve Pay

108 endpoints from openapi.yaml

Generate a Checkout Link API

Generate an Infinity Checkout link. Returns a redirect URL where the customer can complete payment on Pine Labs' hosted checkout page.

Server

POSThttps://pluraluat.v2.pinepg.in/api/checkout/v1/orders

Bearer

Required

Request Body (editable JSON)

{
  "merchant_order_reference": "112345",
  "order_amount": {
    "value": 50000,
    "currency": "INR"
  },
  "integration_mode": "REDIRECT",
  "allowed_payment_methods": [
    "CARD",
    "UPI"
  ],
  "notes": "Order1",
  "callback_url": "https://sample-callback-url",
  "purchase_details": {
    "customer": {
      "email_id": "john@example.com",
      "first_name": "Kevin",
      "last_name": "Bob",
      "customer_id": "123456",
      "mobile_number": "9876543210",
      "country_code": "91",
      "billing_address": {
        "address1": "10 Downing Street Westminster London",
        "address2": "Oxford Street Westminster London",
        "address3": "Baker Street Westminster London",
        "pincode": "51524036",
        "city": "Westminster",
        "state": "Westminster",
        "country": "London",
        "full_name": "Kevin Bob",
        "address_type": "Home",
        "address_category": "billing"
      },
      "shipping_address": {
        "address1": "10 Downing Street Westminster London",
        "address2": "Oxford Street Westminster London",
        "address3": "Baker Street Westminster London",
        "pincode": "51524036",
        "city": "Westminster",
        "state": "Westminster",
        "country": "London",
        "full_name": "Kevin Bob",
        "address_type": "Home",
        "address_category": "billing"
      }
    },
    "product": [
      {
        "product_code": "redmi_10",
        "product_amount": {
          "value": 50000,
          "currency": "INR"
        }
      }
    ]
  }
}

Request Body Schemarequired

FieldDetails

merchant_order_reference

stringrequired

**Idempotency Key.** Unique identifier for the order request. Duplicate requests with the same `merchant_order_reference` will return the existing order instead of creating a new one.

order_amount

objectrequired2 nested fields

Monetary amount with currency.

value

integerrequired

Amount in the smallest currency unit (e.g., paisa for INR).

Constraints

Minimum value: 100Maximum value: 50000000000

currency

stringrequired

Three-letter ISO 4217 currency code.

Constraints

Default value: INR

integration_mode

string

The integration mode through which you want to accept payments. By default, the integration mode is set to REDIRECT.

Allowed values

REDIRECTIFRAMESDKSEAMLESS

pre_auth

boolean

The pre-authorization type. false (default): When pre-authorization is not required. true: When pre-authorization is needed.

allowed_payment_methods

string[]

The type of payment methods you want to offer your customers.

Constraints

Allowed item values:

CARDUPIPOINTSNETBANKINGWALLETCREDIT_EMIDEBIT_EMIBNPL

notes

string

The note you want to show against an order.

callback_url

string

URL to redirect your customers to specific success or failure pages.

purchase_details

object2 nested fields

Object that contains the details of customer information and product details.

customer

object8 nested fields

Customer details for checkout.

email_id

string

Customer's email address.

first_name

string

Customer's first name.

last_name

string

Customer's last name.

customer_id

string

Unique identifier of the customer.

Constraints

Maximum length: 19 characters

mobile_number

string

Customer's mobile number.

country_code

string

Country code of the mobile number.

billing_address

object10 nested fields

Physical address.

address1

string

Address line 1.

Constraints

Maximum length: 100 characters

address2

string

Address line 2.

Constraints

Maximum length: 100 characters

address3

string

Address line 3.

Constraints

Maximum length: 100 characters

pincode

string

Postal/ZIP code.

Constraints

Minimum length: 3 charactersMaximum length: 11 characters

Pattern: ^[a-zA-Z0-9 \-]*$

city

string

City name.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.()]*$

state

string

State or province.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.]*$

country

string

Country name.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.]*$

full_name

string

Full name of the address holder.

Constraints

Maximum length: 100 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s/\-,.'_]*$

address_type

string

Type of address (e.g., Home, Office).

Constraints

Maximum length: 20 characters

address_category

string

Category of the address.

Allowed values

billingshipping

Constraints

Maximum length: 20 characters

shipping_address

object10 nested fields

Physical address.

address1

string

Address line 1.

Constraints

Maximum length: 100 characters

address2

string

Address line 2.

Constraints

Maximum length: 100 characters

address3

string

Address line 3.

Constraints

Maximum length: 100 characters

pincode

string

Postal/ZIP code.

Constraints

Minimum length: 3 charactersMaximum length: 11 characters

Pattern: ^[a-zA-Z0-9 \-]*$

city

string

City name.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.()]*$

state

string

State or province.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.]*$

country

string

Country name.

Constraints

Maximum length: 50 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s\-'&.]*$

full_name

string

Full name of the address holder.

Constraints

Maximum length: 100 characters

Pattern: ^[\p{L}\p{M}\p{Nd}\s/\-,.'_]*$

address_type

string

Type of address (e.g., Home, Office).

Constraints

Maximum length: 20 characters

address_category

string

Category of the address.

Allowed values

billingshipping

Constraints

Maximum length: 20 characters

product

CheckoutProduct[]2 nested fields

Mandatory for EMI Order. An array of objects that contains the list of product details.

product_code

string

Unique product identifier.

product_amount

object2 nested fields

Monetary amount with currency.

value

integerrequired

Amount in the smallest currency unit (e.g., paisa for INR).

Constraints

Minimum value: 100Maximum value: 50000000000

currency

stringrequired

Three-letter ISO 4217 currency code.

Constraints

Default value: INR