PHP SDK

composer require dime-technology/dime-php-sdk

$dime = new \DimePayments\Sdk\Client('your-api-token');

$txn = $dime->transactions->chargeCard('YOUR_SID', [
    'amount' => 49.99,
    'token'  => 'tok_abc123',
]);

echo $txn->transactionStatus; // "Success"

use DimePayments\Sdk\Client;
use DimePayments\Sdk\Config;

// Simple setup
$dime = new Client('your-api-token');

// Full control
$dime = new Client(new Config(
    token:      'your-api-token',
    baseUrl:    'https://app.dimepayments.com',
    timeout:    30.0,
    maxRetries: 2,
));

// Look up (or create) the items a line can reference
$item = $dime->invoices->createItem('YOUR_SID', [
    'name'           => 'Consulting',
    'price'          => 125,
    'tax_deductible' => false,
]);

// Create a draft invoice
$invoice = $dime->invoices->create('YOUR_SID', [
    'customer_uuid'  => $customer->uuid,
    'customer_name'  => 'Jane Doe',
    'customer_email' => 'jane@example.com',
    'payment_terms'  => 'net_15', // due_on_receipt | net_15 | net_30 | net_60
    'lines'          => [
        ['item_id' => $item->id, 'name' => 'Consulting', 'quantity' => 2, 'unit_price' => 125],
    ],
]);

// Email it, or activate the pay link without emailing
$dime->invoices->send('YOUR_SID', $invoice->id);
$dime->invoices->markSent('YOUR_SID', $invoice->id);

// Share the public pay link
echo $dime->invoices->link('YOUR_SID', $invoice->id)->publicUrl;

// Take a merchant-initiated payment. payment_type is required; omit amount to
// pay the full balance.
$dime->invoices->pay('YOUR_SID', $invoice->id, [
    'payment_type' => 'cc', // cc | ach
    'token'        => 'tok_abc123',
    'amount'       => 125.00,
]);

$template = $dime->invoices->createRecurring('YOUR_SID', [
    'customer_uuid'        => $customer->uuid,
    'payment_terms'        => 'net_30',
    'recurring_frequency'  => 'Monthly', // Weekly | Biweekly | FirstFifteenth | Monthly | Yearly
    'recurring_start_date' => '2026-09-01',
    'lines'                => [
        ['item_id' => $item->id, 'name' => 'Retainer', 'quantity' => 1, 'unit_price' => 500],
    ],
]);

$dime->invoices->cancelRecurring('YOUR_SID', $template->id);

use DimePayments\Sdk\Exceptions\DimeException;
use DimePayments\Sdk\Exceptions\ValidationException;

try {
    $dime->transactions->chargeCard('YOUR_SID', ['amount' => 0]);
} catch (ValidationException $e) {
    $e->getErrors();   // ['data.amount' => ['must be greater than 0']]
} catch (DimeException $e) {
    $e->getStatusCode();
}