Better Payment 0.11.1 API
    Preparing search index...

    Class KuveytTurk

    Kuveyt Türk Sanal POS (KT Pay Gate, JSON API)

    • initThreeDSPayment(): Payment; returns the bank's 3D Secure page (HTML)
    • completeThreeDSPayment(): checks the successUrl POST, then charges with Provision
    • cancel(): SaleReversal "Cancel" (same day, before end of day)
    • refund(): SaleReversal "Drawback" (full) or "PartialDrawback"
    • getPayment(): GetTransactions by merchant order id

    paymentId is the merchant order id (conversationId, or a generated one). The bank's own order id is looked up with GetTransactions where it is needed.

    Hierarchy (View Summary)

    Index
    • Pre-authorization: blocks the amount on the card without charging it. Charge it later with capture(), or release it with voidAuthorization(). A success result means the amount is blocked.

      Parameters

      Returns Promise<PaymentResponse>

    • Charges (all or part of) a pre-authorized amount

      Parameters

      • _request: CaptureRequest

      Returns Promise<PaymentResponse>

    • Completes the payment after the successUrl POST.

      The callback is not signed, so it is never trusted on its own: the order is looked up at the bank, the bank's order id must match, and the payment succeeds only when Provision (which charges the card) succeeds. The amount sent with Provision is the bank's recorded amount, not a callback field.

      paymentId and conversationId are set only once the order is confirmed at the bank: on success, and on a timeout after the order was confirmed (the outcome is then unknown). A failure never carries ids taken from the callback, so a forged callback cannot name an existing order. A callback that does not match an order at the bank is rejected as INVALID_HASH.

      Parameters

      Returns Promise<PaymentResponse>

    • Deletes a saved card

      Parameters

      • _request: DeleteCardRequest

      Returns Promise<DeleteCardResponse>

    • Order status via GetTransactions. paymentId is the merchant order id.

      Parameters

      • paymentId: string

      Returns Promise<PaymentResponse>

    • A customer's saved cards

      Parameters

      • _request: { customerToken: string }

      Returns Promise<ListCardsResponse>

    • Saves a card with the provider without charging it

      Parameters

      • _request: SaveCardRequest

      Returns Promise<SaveCardResponse>

    • Releases a pre-authorization; nothing is charged

      Parameters

      • _request: VoidAuthorizationRequest

      Returns Promise<CancelResponse>