Credit Card API & SDK

// Place the file in your project and require it:
require __DIR__ . '/EkstraPayCC.php';   // classes: EkstraPayCC, EkstraPayException

// Place the file in your project and require it:
const { EkstraPayCC, EkstraPayError } = require('./ekstrapay-cc');
// (ESM: import EkstraPayCC from './ekstrapay-cc.js' after adding module.exports interop)

$cc = new EkstraPayCC(
    'YOUR_API_KEY',
    'YOUR_API_TOKEN',
    'https://v2.ekstrapay.com/api',   // optional
    30                                // optional timeout (seconds)
);

const cc = new EkstraPayCC({
  apiKey: 'YOUR_API_KEY',
  apiToken: 'YOUR_API_TOKEN',
  baseUrl: 'https://v2.ekstrapay.com/api',   // optional
  timeout: 30000,                            // optional (ms)
});

require 'EkstraPayCC.php';

$cc = new EkstraPayCC('YOUR_API_KEY', 'YOUR_API_TOKEN');

try {
    $res = $cc->createPayment([
        'amount'             => 250.75,
        'order_id'           => 'ORD-1001',
        'customer_ref'       => 'cust-123',
        'tc_no'              => '11111111111',
        'first_name'         => 'Ali',
        'last_name'          => 'Veli',
        'email'              => '[email protected]',
        'phone'              => '+905321234567',
        'birth_date'         => '1990-06-20',
        'birth_place'        => 'Istanbul',
        'address'            => 'Ornek Mah. No:1',
        'city'               => 'Istanbul',
        'zip_code'           => '34000',
        'return_url_success' => 'https://merchant.com/ok',
        'return_url_fail'    => 'https://merchant.com/fail',
    ]);

    if ($res['payment_type'] === '3d') {
        header('Location: ' . $res['redirect_url']);            // bank 3D page
    } else { // native | link
        header('Location: ' . $res['pay_screen']['pay_url']);   // hosted screen
    }

    if (!empty($res['kyc'])) {
        $code = $res['kyc']['code'];                            // 6-digit KYC code
    }
} catch (EkstraPayException $e) {
    error_log($e->errorCode . ' - ' . $e->getMessage());        // e.g. CC-API-004 - ...
}

const { EkstraPayCC, EkstraPayError } = require('./ekstrapay-cc');

const cc = new EkstraPayCC({ apiKey: 'YOUR_API_KEY', apiToken: 'YOUR_API_TOKEN' });

try {
  const res = await cc.createPayment({
    amount: 250.75,
    order_id: 'ORD-1001',
    customer_ref: 'cust-123',
    tc_no: '11111111111',
    first_name: 'Ali', last_name: 'Veli',
    email: '[email protected]', phone: '+905321234567',
    birth_date: '1990-06-20', birth_place: 'Istanbul',
    address: 'Ornek Mah. No:1', city: 'Istanbul', zip_code: '34000',
    return_url_success: 'https://merchant.com/ok',
    return_url_fail: 'https://merchant.com/fail',
  });

  if (res.payment_type === '3d') {
    res_redirect(res.redirect_url);                 // bank 3D page
  } else {                                          // native | link
    res_redirect(res.pay_screen.pay_url);           // hosted screen
  }

  if (res.kyc) showKycCode(res.kyc.code);           // 6-digit KYC code

} catch (e) {
  console.error(e.errorCode, '-', e.message);       // e.g. CC-BLOCK-001 - ...
}

$st  = $cc->checkPayment('550e8400-...');          // ['status' => [...], 'amount' => '250.75', ...]
$st  = $cc->checkPayment('550e8400-...', true);    // sync with provider
$cc->cancelPayment('550e8400-...');
$det = $cc->detailPayment('550e8400-...');

const st  = await cc.checkPayment('550e8400-...');        // { status:{...}, amount:'250.75', ... }
const st2 = await cc.checkPayment('550e8400-...', true);  // sync with provider
await cc.cancelPayment('550e8400-...');
const det = await cc.detailPayment('550e8400-...');

try {
    $res = $cc->createPayment(['amount' => 5, 'order_id' => 'ORD-9']);
} catch (EkstraPayException $e) {
    switch ($e->errorCode) {
        case 'CC-API-003': /* amount out of range */ break;
        case 'CC-BLOCK-001': /* customer blocked */ break;
        default: error_log("{$e->httpCode} {$e->errorCode} {$e->getMessage()}");
    }
}

try {
  await cc.createPayment({ amount: 5, order_id: 'ORD-9' });
} catch (e) {
  switch (e.errorCode) {
    case 'CC-API-003': /* amount out of range */ break;
    case 'CC-BLOCK-001': /* customer blocked */ break;
    default: console.error(e.httpCode, e.errorCode, e.message, e.data);
  }
}

require 'EkstraPayCC.php';

$payload = json_decode(file_get_contents('php://input'), true);

if (!EkstraPayCC::verifyCallback($payload)) {
    http_response_code(400); exit;                 // forged / tampered
}
if ($payload['status'] === 'CC_APPROVED') {
    mark_order_paid($payload['order_id'], $payload['transaction_id']);
}
http_response_code(200);                           // acknowledge

const { EkstraPayCC } = require('./ekstrapay-cc');

app.post('/cc/callback', express.json(), (req, res) => {
  if (!EkstraPayCC.verifyCallback(req.body)) return res.sendStatus(400); // forged
  if (req.body.status === 'CC_APPROVED') {
    markOrderPaid(req.body.order_id, req.body.transaction_id);
  }
  res.sendStatus(200);                                                    // acknowledge
});