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

Create Customer

Create a new customer profile in the Pine Labs Online system. The customer profile can be used for tokenization and recurring payment operations.

Server

POSThttps://pluraluat.v2.pinepg.in/api/v1/customer

Bearer

Required

Request Body (editable JSON)

{
  "merchant_customer_reference": "82d57572-057c-4826-5775-385a52150554",
  "first_name": "Kevin",
  "last_name": "Bob",
  "country_code": "91",
  "mobile_number": "9876543210",
  "email_id": "kevin@example.com",
  "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"
  },
  "gstin": "28ABCDE1234F2Z6",
  "merchant_metadata": {
    "clientId": "DD",
    "transactionReferenceNo": "pine-1223",
    "merchantId": "1234",
    "tid": "9000990",
    "acquirerName": "HDFC_FSS",
    "isOfferDisplayRequired": "true",
    "OfferData": "UHJvZHVjdF9Db2RlPSIgIiZQcm9kdWN0X05hbWU9IiImUGF5bWVudF9Nb2RlPUJhbmsgRU1JJkNhcmRfVHlwZT1EZWJpdCBDYXJkJkJhbmtfTmFtZT1IREZDIERlYml0JkVNSV9UZW51cmU9NiZJbnRlcmVzdF9SYXRlPTkuMCZJbnRlcmVzdF9BbW91bnQ9MTM4MTQwJk1vbnRobHlfSW5zdGFsbG1lbnQ9ODk0NjkwJkF1dGhvcml6YXRpb25fQW1vdW50PTEwMCZMb2FuX2Jvb2tpbmdfQW1vdW50PTUyMzAwMDAmSW50ZXJlc3RfQ2FzaGJhY2tfQW1vdW50PTAmSW50ZXJlc3RfQ2FzaGJhY2tfVHlwZT1EZWZlcnJlZCZBZGRpdGlvbmFsX0Nhc2hiYWNrPSIiJkFkZGl0aW9uYWxfQ2FzaGJhY2tfVHlwZT0iIiZEZXNjcmlwdGlvbj1CYW5rIEVNSSZQcm9kdWN0X1ZhbHVlPTUyMzAwMDA",
    "tenant_id": "PGATPOS",
    "is_offer_validation_required": "true"
  }
}

Request Body Schemarequired

FieldDetails

merchant_customer_reference

string

Unique customer reference assigned by the merchant.

Constraints

Minimum length: 1 characterMaximum length: 50 characters

first_name

string

Customer's first name.

Constraints

Minimum length: 1 characterMaximum length: 50 characters

last_name

string

Customer's last name.

Constraints

Minimum length: 1 characterMaximum length: 50 characters

country_code

string

Country code of the registered mobile number. Defaults to 91.

Constraints

Maximum length: 5 characters

mobile_number

string

Customer's mobile number.

Constraints

Minimum length: 10 charactersMaximum length: 20 characters

Pattern: ^[0-9]+$

email_id

string

Customer's email address.

Constraints

Maximum length: 50 characters

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

gstin

string

Customer's unique GSTIN (Goods and Services Tax Identification Number).

merchant_metadata

object

Arbitrary key-value pairs for merchant use. Maximum 10 pairs, 256 characters each.

Constraints

Maximum properties: 10

Additional properties: string · Maximum length: 256 characters