> ## Documentation Index > Fetch the complete documentation index at: https://developer.kalixo.io/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a payment ## OpenAPI ````yaml /checkout/openapi.yaml get /v1/payments/{id} openapi: 3.1.0 info: title: Kalixo Checkout API version: '2026-10-01' summary: Payment orchestration API for Kalixo partners. description: > Kalixo Checkout lets partners collect payments from their shoppers through one provider-neutral API. Kalixo is merchant of record and handles payment processing, so partners never integrate a payment provider directly. - Amounts are integers in the currency's minor unit (EUR 49.99 = `4999`). - Server endpoints use a secret key (`kc_sk_test_...` or `kc_sk_live_...`). - Client endpoints are called by `Kalixo.js` with a publishable key and the checkout session's `client_secret`. - Every `POST` with a secret key requires an `Idempotency-Key` header. contact: name: Kalixo Checkout integrations email: integrations@kalixo.io license: name: Proprietary url: https://kalixo.io/legal servers: - url: https://checkout.kalixo.io description: Live - url: https://sandbox.checkout.kalixo.io description: Sandbox (test keys only, connected to the provider test environment) security: - secretKey: [] tags: - name: Checkout sessions description: >- Create a session with the amount to charge, then show it with Kalixo.js or the hosted checkout. - name: Payments description: Read payments and capture or cancel authorized payments. - name: Refunds description: Full and partial refunds of captured payments. - name: Payment links description: Kalixo-hosted payment links that survive provider switches. - name: Customers description: Customers and their stored payment methods for one-click checkout. - name: Disputes description: Chargebacks and information requests, plus evidence upload. - name: Events description: The event log behind webhooks. - name: Webhook endpoints description: Where Kalixo delivers signed events. - name: Reports description: CSV exports of transactions for reconciliation and partner invoicing. - name: Client description: Called by Kalixo.js and the hosted checkout. Not for partner servers. paths: /v1/payments/{id}: parameters: - $ref: '#/components/parameters/PathId' get: tags: - Payments summary: Retrieve a payment operationId: retrievePayment responses: '200': description: The payment. content: application/json: schema: $ref: '#/components/schemas/Payment' default: $ref: '#/components/responses/Error' components: parameters: PathId: name: id in: path required: true schema: type: string schemas: Payment: type: object required: - id - object - status - amount - currency - amount_authorized - amount_captured - amount_refunded - amount_disputed - amount_capturable - capture_method - reference - metadata - version - created_at - livemode properties: id: type: string examples: - pay_01JABCDEF object: type: string const: payment status: $ref: '#/components/schemas/PaymentStatus' amount: $ref: '#/components/schemas/Amount' currency: $ref: '#/components/schemas/Currency' amount_authorized: $ref: '#/components/schemas/Amount' amount_captured: $ref: '#/components/schemas/Amount' amount_refunded: $ref: '#/components/schemas/Amount' amount_disputed: $ref: '#/components/schemas/Amount' amount_capturable: $ref: '#/components/schemas/Amount' amount_mismatch: type: boolean description: >- True if the provider reported an amount different from the expected one. capture_method: $ref: '#/components/schemas/CaptureMethod' checkout_session: type: string customer: type: - string - 'null' reference: type: string description: type: - string - 'null' payment_method: $ref: '#/components/schemas/PaymentMethodDetails' last_payment_error: oneOf: - $ref: '#/components/schemas/PaymentError' - type: 'null' metadata: $ref: '#/components/schemas/Metadata' version: type: integer description: Increases with every change. authorized_at: type: - string - 'null' format: date-time captured_at: type: - string - 'null' format: date-time canceled_at: type: - string - 'null' format: date-time created_at: type: string format: date-time updated_at: type: string format: date-time livemode: type: boolean PaymentStatus: type: string enum: - requires_payment_method - processing - requires_action - authorized - partially_captured - captured - partially_refunded - refunded - canceled - expired - disputed - charged_back Amount: type: integer format: int64 minimum: 0 description: Amount in the currency's minor unit. Currency: type: string pattern: ^[A-Z]{3}$ description: ISO 4217 currency code, uppercase. examples: - EUR CaptureMethod: type: string enum: - automatic - manual PaymentMethodDetails: type: object properties: type: type: string examples: - card - ideal - applepay - googlepay brand: type: - string - 'null' examples: - visa last4: type: - string - 'null' exp_month: type: - integer - 'null' exp_year: type: - integer - 'null' stored_payment_method: type: - string - 'null' description: '`pm_...` if this payment used or saved a stored method.' PaymentError: type: object properties: code: type: string examples: - payment_declined decline_code: type: - string - 'null' examples: - insufficient_funds message: type: string Metadata: type: object description: >- Up to 50 keys. Keys up to 40 characters, values up to 500 characters. Echoed back unchanged. additionalProperties: type: string maxLength: 500 maxProperties: 50 ErrorResponse: type: object required: - error properties: error: type: object required: - type - code - message - request_id properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - idempotency_error - payment_error - rate_limit_error - api_error code: type: string examples: - amount_locked decline_code: type: - string - 'null' message: type: string param: type: - string - 'null' request_id: type: string responses: Error: description: Error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: secretKey: type: http scheme: bearer description: Secret key, `kc_sk_test_...` or `kc_sk_live_...`. Server-side only. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.