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

GET /v1/payments/{paymentCode}
Authorization: Bearer ptk_live_…

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

200 OK:

{
  "paymentCode": "pay_7Hq2bL",
  "partnerTxCode": "ORD-2026-8841",
  "status": "captured",
  "amount": 125050,
  "currency": "try",
  "installmentCount": 3,
  "maskedPan": "4242 42** **** 4242",
  "cardFamily": "credit",
  "cardBank": "Example Bank",
  "appliedRateBps": 250,
  "appliedFixedFee": 25,
  "commissionAmount": 3151,
  "netToPartner": 121899,
  "expectedValueDate": "2026-06-16",
  "refunds": [],
  "createdAt": "2026-06-14T12:00:00Z",
  "updatedAt": "2026-06-14T12:05:11Z"
}

Field	Description
`paymentCode`	Paytalya 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`. Empty list (`[]`) when there are no refunds.
`createdAt` / `updatedAt`	Timestamps (UTC).