Better Payment 0.11.1 API
    Preparing search index...

    Class Est

    EST (Asseco) virtual POS, shared by İş Bankası, Ziraat Bankası, Halkbank, TEB and Şekerbank. One provider class, configured per bank.

    • createPayment(): XML API Auth (non-3D)
    • initThreeDSPayment(): auto-submitting form to /fim/est3Dgate (storetype 3d, 3d_pay, 3d_pay_hosting or 3d_host), signed with hash ver3
    • completeThreeDSPayment(): verifies the callback hash; 3d / 3d_host charge with XML Auth, 3d_pay / 3d_pay_hosting are confirmed with an order status query
    • refund() Credit, cancel() Void, getPayment() order status (ORDERSTATUS)

    paymentId is your order id (oid): the conversationId you pass, or a generated one.

    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 okUrl / failUrl POST.

      The ver3 hash covers the values but not the field names, so a valid hash alone does not pin which value is the order id. The result is therefore confirmed with the bank: 3d and 3d_host only authenticate the card, so they charge with XML Auth (the bank's answer decides); in 3d_pay and 3d_pay_hosting the bank charged the card, which is checked with an order status query. A callback that fails the hash, names another store, or claims a payment the bank does not confirm is rejected as INVALID_HASH.

      paymentId and conversationId are set only for a payment the bank confirmed, and on a timeout after the bank was reached for this order; a failure never carries ids taken from the callback.

      Parameters

      Returns Promise<PaymentResponse>

    • Deletes a saved card

      Parameters

      • _request: DeleteCardRequest

      Returns Promise<DeleteCardResponse>

    • Order status (ORDERSTATUS). paymentId is the 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>