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 Card Token

Generate a network token for a card linked to a customer. This tokenizes the card details and returns a token that can be used for subsequent transactions.

Server

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

Bearer

Required

Request Body (editable JSON)

{
  "customer_id": "cust-v1-0811030624-aa-RBDgpR",
  "merchant_token_reference": "token-ref-001",
  "payment_method": "CARD",
  "payment_option": {
    "encrypted_card_details": "akdsdsdsh12k12h1k21h2khakshakhakshkh121h2k1hak"
  },
  "payment": {
    "acquirer_data": {
      "approval_code": "030376",
      "acquirer_reference": "202455840588334",
      "rrn": "419335023601",
      "auth_reference": "AUTH12345678"
    }
  },
  "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

customer_id

stringrequired

Unique identifier of the customer in the Pine Labs Online database.

Constraints

Maximum length: 50 characters

merchant_token_reference

stringrequired

**Idempotency Key.** Unique token reference assigned by the merchant. Duplicate requests with the same `merchant_token_reference` will return the existing token instead of creating a new one.

Constraints

Maximum length: 50 characters

payment_method

stringrequired

Payment method for which the token is being generated. Currently only CARD is supported.

Allowed values

CARD

payment_option

object1 nested field

An object that contains the payment option details.

encrypted_card_details

string

Encrypted card details.

Constraints

Minimum length: 1 characterMaximum length: 50 characters

payment

object1 nested field

An object that contains the payment details.

acquirer_data

object4 nested fields

An object that contains the acquirer details.

approval_code

string

Authorization code returned from acquirer against the payment.

acquirer_reference

string

Unique reference returned from acquirer for the payment.

rrn

string

Retrieval reference number returned from acquirer for the payment.

auth_reference

string

**Mandatory** for rupay transaction. A unique identifier linking the authorization request to the transaction.

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