Skip to content
Lydia GateLydia GateLydia Gate

Get Payment

You query the authoritative status and detail of a payment. The result carried to the buyer’s returnUrl after the 3D return (whether the channel is web (browser 303) or mobile (WebView)) is not authoritative; you always learn the definitive result from this endpoint (or from a webhook). There are two forms.

By code

Section titled “By code”
GET /v1/payments/{paymentCode}
Authorization: Bearer ptk_live_…

By partner transaction code

Section titled “By partner transaction code”

You can also query by your own partnerTxCode (e.g., to check status before a webhook arrives):

GET /v1/payments?partnerTxCode=ORD-2026-8841
Authorization: Bearer ptk_live_…

Response

Section titled “Response”

200 OK:

{
  "paymentCode": "pay_7Hq2bL",
  "partnerTxCode": "ORD-2026-8841",
  "status": "captured",
  "amount": 125050,
  "currency": "try",
  "installmentCount": 3,
  "maskedPan": "416607******9587",
  "cardFamily": "credit",
  "cardBank": "Example Bank",
  "appliedRateBps": 250,
  "appliedFixedFee": 25,
  "commissionAmount": 3151,
  "netToPartner": 121899,
  "expectedValueDate": "2026-06-16",
  "refunds": [
    {
      "refundId": "ref_5Tg8p",
      "amount": 40000,
      "status": "pending"
    }
  ],
  "createdAt": "2026-06-14T12:00:00Z",
  "updatedAt": "2026-06-14T12:05:11Z"
}
Field Description
paymentCode Lydia Gate payment id.
partnerTxCode Your own transaction reference.
status Customer-visible status. See Payment Lifecycle.
amount Sale amount (kuruş).
currency Currency.
installmentCount Number of installments (1 for single payment).
maskedPan Masked card number; the full PAN is never returned. null if not yet determined.
cardFamily Card family (if known; otherwise null).
cardBank Issuing bank (if known; otherwise null).
appliedRateBps Applied commission rate, integer basis points (2.5% → 250). null if not yet computed.
appliedFixedFee Applied fixed fee (kuruş; if any).
commissionAmount Calculated commission amount (kuruş; if any).
netToPartner Net amount payable to you after commission (kuruş; if any).
expectedValueDate Expected value (settlement) date (if any).
refunds List of refund items; each item has refundId, amount (kuruş), and status (pending / approved / declined). A pending refund does not change the payment’s overall status yet (see Refunds & Void). Empty list ([]) when there are no refunds.
createdAt / updatedAt Timestamps (UTC).