Skip to main content

Installation

Requires PHP 8.3+
composer require dime-technology/dime-php-sdk

Quickstart

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

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

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

Configuration

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

Available Resources

PropertyEndpoints
$dime->transactionscharge card/ACH, tokenize, refund, void, show, list
$dime->customerslist, show, create, update, delete
$dime->paymentMethodslist, show, create, update, delete
$dime->merchantslist, show, create, update, get onboarding form link
$dime->addresseslist, show, create, update, delete
$dime->depositslist, list-with-transactions, show
$dime->recurringPaymentslist, show, create, edit, pause, cancel, activate, delete

Error Handling

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