Decoupled Authorization

POST/api/pay/v1/orders/{order_id}/payments/{payment_id}/authorize

Perform decoupled authorization for an already authenticated transaction.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`order_id`	`string`required	Unique identifier of the order in the Pine Labs Online database.
`payment_id`	`string`required	Unique identifier of the payment in the Pine Labs Online database. Maximum length: 50 characters.

Request Body

Name	Type	Description
`decrypted_card_details`	`object`	An object that contains the decrypted card details.
`pan`	`string`	Plain Card number
`cvv`	`string`	CVV of the card.
`card_holder_name`	`string`	Name of the card holder.
`token`	`string`	Unique identifier of the card as per the token transaction type.
`expiration_month`	`string`required	Card token expiry month. Must be 2 digits.
`expiration_year`	`string`required	Card token expiry year. Must be 4 digits.
`cryptogram`	`string`	Unique encrypted text.
`cavv`	`string`	Unique encrypted text.
`eci`	`string`	Indicates the authentication outcome for the transaction.
`acquirer_payment_details`	`object`	An object that contains acquirer related details
`directory_server_transaction_id`	`string`	Transaction ID generated by Directory Server
`acs_transaction_id`	`string`	Transaction ID generated by Access Control Server
`three_ds_server_transaction_id`	`string`	Transaction ID generated by 3ds server
`three_ds_version`	`string`	3ds version
`authentication_type`	`string`	Authentication mechanism used Allowed values: `3dspasskey`

Response

Name	Type	Description
`data`	`object`
`order_id`	`string`
`merchant_order_reference`	`string`
`type`	`string`	Allowed values: `CHARGEREFUND`
`status`	`string`	Allowed values: `CREATEDPENDINGPROCESSEDAUTHORIZEDCANCELLEDATTEMPTEDFAILEDFULLY_REFUNDEDPARTIALLY_REFUNDED`
`callback_url`	`string`
`failure_callback_url`	`string`
`merchant_id`	`string`
`order_amount`	`object`
`pre_auth`	`boolean`
`part_payment`	`boolean`	Whether the transaction is a part payment.
`allowed_payment_methods`	`string[]`
`purchase_details`	`object`
`payments`	`object[]`
`created_at`	`string`
`updated_at`	`string`
`integration_mode`	`string`	Allowed values: `SEAMLESSREDIRECT`

Status Codes

`200`	Payment authorized successfully.
`400`	The request was malformed or missing required fields.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`404`	The requested resource does not exist.
`422`	Unprocessable Entity
`500`	An unexpected error occurred on the server.

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/orders/v1-4405071524-aa-qlAtAf/payments/v1-5206071124-aa-mpLhF3-cc-l/authorize \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "decrypted_card_details": {
    "pan": "4111111111111111",
    "cvv": "321",
    "card_holder_name": "Adrien",
    "token": "4111111111111111",
    "expiration_month": "12",
    "expiration_year": "2031",
    "cryptogram": "AceY+igABPs3jdwNaDg3MAACAAA=",
    "cavv": "AceY+igABPs3jdwNaDg3MAACAAA=",
    "eci": "05"
  },
  "acquirer_payment_details": {
    "three_ds_version": "2.2.0"
  },
  "authentication_type": "3ds"
}'

Run this request

Bearer token

Path parameters

order_id

payment_id

Request body (JSON)

Status:

200 OK

{
  "data": {
    "order_id": "v1-260701053832-aa-UVB7vO",
    "merchant_order_reference": "3fb59787-c38b-4986-87da-39be0a585fae",
    "type": "CHARGE",
    "status": "PROCESSED",
    "callback_url": "https://simple-callback.onrender.com/payment/callback",
    "failure_callback_url": "",
    "merchant_id": "106974",
    "order_amount": {
      "value": 10000,
      "currency": "INR"
    },
    "pre_auth": false,
    "part_payment": false,
    "allowed_payment_methods": [
      "CARD",
      "WALLET"
    ],
    "purchase_details": {
      "customer": {
        "email_id": "joe.sam@gmail.com",
        "first_name": "joe",
        "last_name": "kumar",
        "mobile_number": "192192883",
        "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",
          "adddress_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",
          "adddress_type": "Home",
          "address_category": "shipping"
        },
        "is_edit_customer_details_allowed": false
      },
      "merchant_metadata": {}
    },
    "payments": [
      {
        "id": "v1-260701053832-aa-UVB7vO-cc-a",
        "merchant_payment_reference": "def750b1-1c14-48fa-ad6e-98d42bdd7fba",
        "status": "PROCESSED",
        "payment_amount": {
          "value": 10000,
          "currency": "INR"
        },
        "payment_method": "CARD",
        "payment_option": {
          "card_data": {
            "card_type": "CREDIT",
            "network_name": "VISA",
            "issuer_name": "INTL HDQTRS-CENTER OWNED",
            "card_category": "Consumer",
            "country_code": "IND",
            "token_txn_type": "ALT_TOKEN",
            "last4_digit": 1004,
            "save": false,
            "card_holder_name": "Adrien"
          }
        },
        "acquirer_data": {
          "approval_code": "831000",
          "acquirer_reference": "19487181",
          "rrn": "515511988482",
          "is_aggregator": true,
          "acquirer_name": "Cyber_Source_AXIS"
        },
        "created_at": "2025-06-04T11:00:56.591Z",
        "updated_at": "2025-06-04T11:01:26.656Z"
      }
    ],
    "created_at": "2025-06-04T11:00:51.067Z",
    "updated_at": "2025-06-04T11:01:26.656Z",
    "integration_mode": "SEAMLESS"
  }
}