Pine LabsDOCS
Create Account

Get Presentation by Merchant Reference

GET/ps/api/v1/public/presentations/reference/{merchant_presentation_reference}

Retrieves a specific presentation by the merchant presentation reference.

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Perplexity
Requires Bearer token. Get token →

Path Parameters

FieldDetails
merchant_presentation_reference
stringrequired

Unique identifier of the merchant presentation reference.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Header Parameters

FieldDetails
Request-Timestamp
stringdate-time

ISO 8601 UTC timestamp of the request. Used for idempotency and audit.

Request-ID
string

Use a global unique identifier [GUID] for the request.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Response

FieldDetails
subscription_id
string

Unique identifier for the subscription.

Constraints
Maximum length: 50 characters
presentation_id
string

Unique identifier for the presentation.

Constraints
Maximum length: 50 characters
due_date
stringdate-time

The ISO 8601 UTC Timestamp when the payment is due.

amount
object2 nested fields

This is the recurring mandate amount, that would be charged for each frequency. For instance 200 every month. This field is not needed if the mandate frequency is AS

value
integerrequired

Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).

Constraints
Minimum value: 100Maximum value: 100000000
currency
stringrequired

Three-letter ISO 4217 currency code.

Constraints
Default value: INR
merchant_presentation_reference
string

Unique identifier of the merchant presentation reference.

Constraints
Minimum length: 1 characterMaximum length: 50 characters
pdn_status
string

Pre-debit notification status.

  • CREATED: Pine Labs received the pre-debit notification request.
  • INITIATED: Pre-debit notification request sent to the Bank.
  • NOTIFIED: Notification delivered successfully.
  • FAILED: Notification delivery attempt unsuccessful.
  • CANCELLED: Notification stopped before completion.
  • PAUSED: Notification temporarily halted.
  • PDN_FAILED: Pre-debit notification failed after all retry attempts.
Allowed values:
CREATEDINITIATEDNOTIFIEDFAILEDCANCELLEDPAUSEDPDN_FAILED
status
string

Presentation status.

  • CREATED: Customer Debit request received.
  • PENDING: Debit request sent to Bank, awaiting response.
  • COMPLETED: Debit successfully received.
  • FAILED: Debit request unsuccessful.
  • CANCELLED: Cancel Subscription request received.
  • PAUSED: Pause subscription request received.
  • PARTIALLY_REFUNDED: Partial refund successful.
  • REFUNDED: Full refund successful.
  • INITIATED: Debit request initiated.
Allowed values:
CREATEDPENDINGCOMPLETEDFAILEDCANCELLEDPAUSEDPARTIALLY_REFUNDEDREFUNDEDINITIATED
failure_count
integer

The number of times the requests to execute mandates at banks have failed.

order_id
string

Unique identifier of the order created for this presentation.

Status Codes

200Presentation retrieved successfully.
400The request was malformed or missing required fields.
Run
Request
curl --request GET \
  --url https://pluraluat.v2.pinepg.in/ps/api/v1/public/presentations/reference/z1B3pu003 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'
{
  "subscription_id": "v1-sub-250911093342-aa-v9YH7S",
  "presentation_id": "v1-bil-250911093822-aa-i37gSm",
  "due_date": "2025-09-12T18:00:00Z",
  "amount": {
    "value": 100,
    "currency": "INR"
  },
  "merchant_presentation_reference": "z1B3pu003",
  "pdn_status": "NOTIFIED",
  "status": "PENDING",
  "failure_count": 0
}