Skip to content
Bank virtual pos

Akbank Virtual POS & 3D_PAY Integration

Connect directly to Akbank's HMAC-SHA512 signed JSON API with 3D_PAY callback verification without third-party fees.

Better Payment
3D_PAYHMAC-SHA512 signed secure requestsTiming-safe 3D callback verification
Protocol

JSON API

Auth

HMAC-SHA512

3D Secure

Included

3D Secure, signed callback

Dependencies

0

Capabilities

Full Akbank support

  • 3D_PAY & Non-3D direct charge support
  • HMAC-SHA512 signed secure requests
  • Timing-safe 3D callback verification
  • Order status lookup, refund & void
  • Special installment logic for Axess cards

How a request flows

  1. 1

    createPayment / initThreeDSPayment

    One typed request, translated into Akbank's format.

  2. 2

    JSON API · HMAC-SHA512

    Signatures and field mappings are generated for you.

  3. 3

    Callback verification

    The signature is compared in constant time and the order match is checked.

  4. 4

    Normalized result

    Success, error code and transaction id come back in one shape.

Connect in one config.

Hand over your credentials; Better Payment handles the rest.

payment-akbank.tsTypeScript
import { createBetterPayment } from "better-payment";

const payment = createBetterPayment({
  defaultProvider: "akbank",
  providers: {
    akbank: {
      clientId: process.env.AKBANK_CLIENT_ID!,
      username: process.env.AKBANK_USERNAME!,
      password: process.env.AKBANK_PASSWORD!,
      storeKey: process.env.AKBANK_STORE_KEY!
    }
  }
});