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);

// Disputes on the merchant, and the documents that answer one
$chargebacks = $dime->chargebacks->list('YOUR_SID', ['representment_status' => 'New']);
$dime->documents->upload('YOUR_SID', [
    'doc_type'                       => 'RetrievalRequest',
    'chargeback_transaction_info_id' => $chargebacks->data[0]->transactionInfoId,
], ['/path/to/receipt.pdf']);

// Held funds (affiliate keys only). The idempotency key makes a retry safe.
$balance = $dime->funds->balance('YOUR_SID');
$result  = $dime->funds->release('YOUR_SID', [
    'idempotency_key' => 'payout-2026-10-06',
    'amount'          => $balance->releasable,
]);
if ($result->release->status !== 'released') {
    // 'failed' (declined, nothing moved) or 'unknown' (check again before retrying)
}

$txn = $dime->transactions->chargeCardToken('YOUR_SID', [
    'amount' => 49.99,
    'token'  => 'abc123def456',
    // ...
], idempotencyKey: 'order-1234-charge');

// Place a hold
$auth = $dime->transactions->authorize('YOUR_SID', [
    'amount' => 100.50,
    'token'  => 'tok_abc123',
    'phone'  => '+17701234567',
]);

// Capture all of it, or pass a smaller amount as the third argument
$dime->transactions->capture('YOUR_SID', $auth->transactionNumber, 87.25);

// Or release the hold without charging
$dime->transactions->void('YOUR_SID', 'CC', $auth->transactionNumber);

$status = $dime->merchants->applicationStatus('YOUR_SID');

if ($status->boarded) {
    // The merchant can take payments
}

// Enroll a customer in a published plan. Charges the first period.
$result = $dime->subscriptionPlans->subscribe('YOUR_SID', $planId, [
    'customer_uuid'  => $customer->uuid,
    'payment_method' => $paymentMethodId,
]);

$dime->subscriptions->pause('YOUR_SID', $subscriptionId);
$dime->subscriptions->resume('YOUR_SID', $subscriptionId);
$dime->subscriptions->cancel('YOUR_SID', $subscriptionId);

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();
}