Hosted Payments: Redirect Customers to a Checkout Page

<?php

require __DIR__ . '/vendor/autoload.php';

use Taliup\Sdk\Client;
use Taliup\Sdk\Exceptions\ApiException;

$client = new Client([
    'merchant_site_id'    => getenv('TALIUP_MERCHANT_SITE_ID'),
    'merchant_secret_key' => getenv('TALIUP_MERCHANT_SECRET_KEY'),
]);

try {
    $response = $client->hostedPayments()->createCheckoutUrl([
        // Required
        'amount'       => 49.99,

        // Recommended
        'currency'     => 'CAD',
        'reference'    => 'ORDER-10029',
        'redirect_url' => 'https://yoursite.com/payment/success',
        'cancel_url'   => 'https://yoursite.com/payment/cancel',

        // Optional customer info
        'first_name'   => 'Jane',
        'last_name'    => 'Doe',
        'email'        => 'jane@example.com',

        // Optional line items
        'items' => [
            [
                'product_id' => 'SKU-001',
                'name'       => 'Widget',
                'quantity'   => 2,
                'price'      => 24.99,
                'subtotal'   => 49.98,
                'tax_total'  => 0.00,
                'sku'        => 'SKU-001',
            ],
        ],

        // Optional webhook and metadata
        'webhook_url'        => 'https://yoursite.com/webhooks/taliup',
        'external_source'    => 'my-platform',
        'expires_in_minutes' => 30,
    ]);

    $checkoutUrl = $response['checkout_url']; // Redirect customer here
    $token       = $response['token'];        // Session token
    $expiresAt   = $response['expires_at'];   // ISO 8601 expiry timestamp

    header('Location: ' . $checkoutUrl);
    exit;
} catch (ApiException $e) {
    // $e->getMessage()      — human-readable error
    // $e->getStatusCode()   — HTTP status code
    // $e->getResponseBody() — raw decoded response
    error_log('Taliup error: ' . $e->getMessage());
}

<?php

require __DIR__ . '/vendor/autoload.php';

use Taliup\Sdk\Client;
use Taliup\Sdk\Exceptions\ApiException;

$client = new Client([
    'merchant_site_id'    => getenv('TALIUP_MERCHANT_SITE_ID'),
    'merchant_secret_key' => getenv('TALIUP_MERCHANT_SECRET_KEY'),
]);

try {
    $result = $client->hostedPayments()->verifyTransaction([
        'token' => $token, // Session token from createCheckoutUrl response
    ]);

    $status        = $result['status'];         // e.g. 'approved' or 'declined'
    $transactionId = $result['transaction_id']; // Taliup's transaction ID
    $amount        = $result['amount'];         // e.g. '49.99'
} catch (ApiException $e) {
    error_log('Taliup error: ' . $e->getMessage());
}