PHP SDK Reference - Devdraft API Documentation

Overview

The Devdraft PHP SDK provides a complete client library for integrating payment processing, customer management, and webhook functionality into your PHP applications.

PSR-7 Compatible

Uses Guzzle HTTP client for reliable API communication

Composer Support

Easy installation via Composer package manager

Comprehensive

Access to all Devdraft API endpoints and features

Modern PHP

Built for PHP 8.1+ with type hints and modern features

Installation

Using Composer

composer require devdraftengineer/php

Or add to your composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/devdraftengineer/php.git"
    }
  ],
  "require": {
    "devdraftengineer/php": "*@dev"
  }
}

Then run:

composer install

Requirements

PHP 8.1 or higher
Composer
Guzzle HTTP client (automatically installed)

Quick Start

<?php
require_once(__DIR__ . '/vendor/autoload.php');

use Devdraft\Configuration;
use Devdraft\Api\TransfersApi;
use Devdraft\Api\WebhooksApi;
use Devdraft\Model\CreateDirectWalletTransferDto;
use GuzzleHttp\Client;

// Configure API credentials
$config = Configuration::getDefaultConfiguration()
    ->setApiKey('x-client-key', getenv('DEVDRAFT_CLIENT_KEY'))
    ->setApiKey('x-client-secret', getenv('DEVDRAFT_CLIENT_SECRET'))
    ->setHost('https://api.devdraft.ai');

// Create API instances
$httpClient = new Client();
$transfersApi = new TransfersApi($httpClient, $config);
$webhooksApi = new WebhooksApi($httpClient, $config);

try {
    // Create a transfer
    $transferDto = new CreateDirectWalletTransferDto([
        'wallet_id' => 'your-wallet-id',
        'network' => 'solana',
        'stable_coin_currency' => 'usdc',
        'amount' => 100.00
    ]);
    
    $transfer = $transfersApi->transferControllerCreateDirectWalletTransfer($transferDto);
    echo "Transfer created: " . $transfer->getId() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

API Classes

The SDK is organized into API classes, each handling a specific domain:

API Class	Description
APIHealthApi	Service health checks and status monitoring
AppBalancesApi	Query application balances across stablecoins
CustomersApi	Customer management and KYC operations
ExchangeRatesApi	Real-time currency exchange rates
InvoicesApi	Invoice creation and management
LiquidationAddressesApi	Cryptocurrency liquidation addresses
PaymentIntentsApi	Payment intent creation for bank and stablecoin
PaymentLinksApi	Generate and manage payment links
ProductsApi	Product catalog management
TaxesApi	Tax configuration and management
TestPaymentsApi	Test payment processing in sandbox
TransfersApi	Initiate and manage fund transfers
WalletsApi	Wallet management and balances
WebhooksApi	Webhook configuration and management

API Health

Monitor service health and availability.

Methods

`healthControllerCheckV0()`

Authenticated health check endpoint requiring API credentials.

<?php
require_once(__DIR__ . '/vendor/autoload.php');

use Devdraft\Api\APIHealthApi;
use GuzzleHttp\Client;

$config = Devdraft\Configuration::getDefaultConfiguration()
    ->setApiKey('x-client-key', getenv('DEVDRAFT_CLIENT_KEY'))
    ->setApiKey('x-client-secret', getenv('DEVDRAFT_CLIENT_SECRET'));

$apiInstance = new APIHealthApi(new Client(), $config);

try {
    $apiInstance->healthControllerCheckV0();
    echo "Service is healthy and authenticated\n";
} catch (Exception $e) {
    echo "Health check failed: " . $e->getMessage() . "\n";
}

Returns: void

`healthControllerPublicHealthCheckV0()`

Public health check endpoint (no authentication required).

$status = $apiInstance->healthControllerPublicHealthCheckV0();
echo "Service status: " . $status->getStatus() . "\n";

Returns: \Devdraft\Model\PublicHealthResponseDto

App Balances

Query your application’s stablecoin balances.

Methods

`balanceControllerGetAllBalances()`

Get all stablecoin balances for your application.

<?php
use Devdraft\Api\AppBalancesApi;
use GuzzleHttp\Client;

$apiInstance = new AppBalancesApi(new Client(), $config);

try {
    $balances = $apiInstance->balanceControllerGetAllBalances();
    echo "USDC Balance: " . $balances->getUsdc() . "\n";
    echo "EURC Balance: " . $balances->getEurc() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Returns: \Devdraft\Model\AllBalancesResponse

`balanceControllerGetUSDCBalance()`

Get USDC balance only.

$usdcBalance = $apiInstance->balanceControllerGetUSDCBalance();
echo "USDC: " . $usdcBalance->getAmount() . "\n";

Returns: \Devdraft\Model\AggregatedBalanceResponse

`balanceControllerGetEURCBalance()`

Get EURC balance only.

$eurcBalance = $apiInstance->balanceControllerGetEURCBalance();
echo "EURC: " . $eurcBalance->getAmount() . "\n";

Returns: \Devdraft\Model\AggregatedBalanceResponse

Customers

Manage customer records and KYC information.

Methods

`customerControllerCreate($create_customer_dto)`

Create a new customer.

<?php
use Devdraft\Api\CustomersApi;
use Devdraft\Model\CreateCustomerDto;
use GuzzleHttp\Client;

$apiInstance = new CustomersApi(new Client(), $config);

try {
    $customerDto = new CreateCustomerDto([
        'first_name' => 'John',
        'last_name' => 'Doe',
        'email' => 'john.doe@example.com',
        'type' => 'INDIVIDUAL',
        'country' => 'US'
    ]);
    
    $customer = $apiInstance->customerControllerCreate($customerDto);
    echo "Customer created: " . $customer->getId() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_customer_dto: \Devdraft\Model\CreateCustomerDto - Customer details

Returns: \Devdraft\Model\Customer

`customerControllerFindAll($page, $limit, $status)`

Get all customers with optional filters.

$page = 1;
$limit = 20;
$status = 'ACTIVE';

try {
    $customers = $apiInstance->customerControllerFindAll($page, $limit, $status);
    
    foreach ($customers as $customer) {
        echo $customer->getFirstName() . " " . $customer->getLastName() . " - " . $customer->getEmail() . "\n";
    }
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$page: int - Page number (optional, default: 1)
$limit: int - Items per page (optional, default: 20)
$status: string - Filter by status (optional)

Returns: \Devdraft\Model\Customer[]

`customerControllerFindOne($id)`

Get a customer by ID.

$customer = $apiInstance->customerControllerFindOne('customer-id-here');
echo "Customer: " . $customer->getFirstName() . " " . $customer->getLastName() . "\n";

Parameters:

$id: string - Customer ID

Returns: \Devdraft\Model\Customer

`customerControllerUpdate($id, $update_customer_dto)`

Update a customer’s information.

use Devdraft\Model\UpdateCustomerDto;

$updateDto = new UpdateCustomerDto([
    'phone' => '+1234567890',
    'address' => '123 Main St'
]);

$updated = $apiInstance->customerControllerUpdate('customer-id-here', $updateDto);
echo "Customer updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Customer ID
$update_customer_dto: \Devdraft\Model\UpdateCustomerDto - Fields to update

Returns: \Devdraft\Model\Customer

Exchange Rates

Get real-time currency exchange rates.

Methods

`exchangeRateControllerGetExchangeRate($from, $to)`

Get exchange rate between any two supported currencies.

<?php
use Devdraft\Api\ExchangeRatesApi;
use GuzzleHttp\Client;

$apiInstance = new ExchangeRatesApi(new Client(), $config);

try {
    $rate = $apiInstance->exchangeRateControllerGetExchangeRate('USD', 'EUR');
    
    echo "1 USD = " . $rate->getRate() . " EUR\n";
    echo "Rate expires at: " . $rate->getExpiresAt() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$from: string - Source currency code
$to: string - Target currency code

Returns: \Devdraft\Model\ExchangeRateResponseDto

`exchangeRateControllerGetUSDToEURRate()`

Get USD to EUR exchange rate.

$usdToEur = $apiInstance->exchangeRateControllerGetUSDToEURRate();
echo "USD to EUR: " . $usdToEur->getRate() . "\n";

Returns: \Devdraft\Model\ExchangeRateResponseDto

`exchangeRateControllerGetEURToUSDRate()`

Get EUR to USD exchange rate.

$eurToUsd = $apiInstance->exchangeRateControllerGetEURToUSDRate();
echo "EUR to USD: " . $eurToUsd->getRate() . "\n";

Returns: \Devdraft\Model\ExchangeRateResponseDto

Invoices

Create and manage invoices for your customers.

Methods

`invoiceControllerCreate($create_invoice_dto)`

Create a new invoice.

<?php
use Devdraft\Api\InvoicesApi;
use Devdraft\Model\CreateInvoiceDto;
use GuzzleHttp\Client;

$apiInstance = new InvoicesApi(new Client(), $config);

try {
    $invoiceDto = new CreateInvoiceDto([
        'customer_id' => 'customer-id',
        'items' => [
            [
                'description' => 'Premium Subscription',
                'quantity' => 1,
                'price' => 99.99,
                'currency' => 'USD'
            ]
        ],
        'due_date' => '2024-12-31'
    ]);
    
    $invoice = $apiInstance->invoiceControllerCreate($invoiceDto);
    echo "Invoice created: " . $invoice->getId() . "\n";
    echo "Total: " . $invoice->getTotal() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_invoice_dto: \Devdraft\Model\CreateInvoiceDto - Invoice details

Returns: \Devdraft\Model\Invoice

`invoiceControllerFindAll($page, $limit, $status)`

Get all invoices.

$invoices = $apiInstance->invoiceControllerFindAll(1, 50, 'UNPAID');

foreach ($invoices as $invoice) {
    echo "Invoice " . $invoice->getId() . ": " . $invoice->getTotal() . "\n";
}

Parameters:

$page: int - Page number (optional)
$limit: int - Items per page (optional)
$status: string - Filter by status (optional)

Returns: \Devdraft\Model\Invoice[]

`invoiceControllerFindOne($id)`

Get an invoice by ID.

$invoice = $apiInstance->invoiceControllerFindOne('invoice-id');
echo "Invoice total: " . $invoice->getTotal() . "\n";

Parameters:

$id: string - Invoice ID

Returns: \Devdraft\Model\Invoice

`invoiceControllerUpdate($id, $update_invoice_dto)`

Update an invoice.

$updateDto = [
    'status' => 'PAID',
    'paid_at' => date('c')
];

$updated = $apiInstance->invoiceControllerUpdate('invoice-id', $updateDto);
echo "Invoice updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Invoice ID
$update_invoice_dto: array - Fields to update

Returns: \Devdraft\Model\Invoice

Liquidation Addresses

Manage cryptocurrency liquidation addresses for customers.

Methods

`liquidationAddressControllerCreateLiquidationAddress($customer_id, $create_liquidation_address_dto)`

Create a new liquidation address for a customer.

<?php
use Devdraft\Api\LiquidationAddressesApi;
use Devdraft\Model\CreateLiquidationAddressDto;
use GuzzleHttp\Client;

$apiInstance = new LiquidationAddressesApi(new Client(), $config);

try {
    $addressDto = new CreateLiquidationAddressDto([
        'network' => 'solana',
        'currency' => 'usdc'
    ]);
    
    $address = $apiInstance->liquidationAddressControllerCreateLiquidationAddress(
        'customer-id',
        $addressDto
    );
    
    echo "Liquidation address: " . $address->getAddress() . "\n";
    echo "Network: " . $address->getNetwork() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$customer_id: string - Customer ID
$create_liquidation_address_dto: \Devdraft\Model\CreateLiquidationAddressDto - Address details

Returns: \Devdraft\Model\LiquidationAddressResponseDto

`liquidationAddressControllerGetLiquidationAddresses($customer_id)`

Get all liquidation addresses for a customer.

$addresses = $apiInstance->liquidationAddressControllerGetLiquidationAddresses('customer-id');

foreach ($addresses as $addr) {
    echo $addr->getNetwork() . ": " . $addr->getAddress() . "\n";
}

Parameters:

$customer_id: string - Customer ID

Returns: \Devdraft\Model\LiquidationAddressResponseDto[]

`liquidationAddressControllerGetLiquidationAddress($customer_id, $liquidation_address_id)`

Get a specific liquidation address.

$address = $apiInstance->liquidationAddressControllerGetLiquidationAddress(
    'customer-id',
    'address-id'
);

echo "Address: " . $address->getAddress() . "\n";

Parameters:

$customer_id: string - Customer ID
$liquidation_address_id: string - Address ID

Returns: \Devdraft\Model\LiquidationAddressResponseDto

Payment Intents

Create payment intents for bank and stablecoin payments.

Methods

`paymentIntentControllerCreateBankPaymentIntent($create_bank_payment_intent_dto)`

Create a bank payment intent.

<?php
use Devdraft\Api\PaymentIntentsApi;
use Devdraft\Model\CreateBankPaymentIntentDto;
use GuzzleHttp\Client;

$apiInstance = new PaymentIntentsApi(new Client(), $config);

try {
    $intentDto = new CreateBankPaymentIntentDto([
        'customer_id' => 'customer-id',
        'amount' => 1000.00,
        'currency' => 'USD',
        'payment_rail' => 'wire'
    ]);
    
    $intent = $apiInstance->paymentIntentControllerCreateBankPaymentIntent($intentDto);
    echo "Payment intent: " . $intent->getId() . "\n";
    echo "Status: " . $intent->getStatus() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_bank_payment_intent_dto: \Devdraft\Model\CreateBankPaymentIntentDto - Intent details

Returns: \Devdraft\Model\PaymentIntent

`paymentIntentControllerCreateStablePaymentIntent($create_stable_payment_intent_dto)`

Create a stablecoin payment intent.

use Devdraft\Model\CreateStablePaymentIntentDto;

$stableIntentDto = new CreateStablePaymentIntentDto([
    'customer_id' => 'customer-id',
    'amount' => 500.00,
    'currency' => 'usdc',
    'network' => 'solana'
]);

$stableIntent = $apiInstance->paymentIntentControllerCreateStablePaymentIntent($stableIntentDto);
echo "Stable intent: " . $stableIntent->getId() . "\n";

Parameters:

$create_stable_payment_intent_dto: \Devdraft\Model\CreateStablePaymentIntentDto - Intent details

Returns: \Devdraft\Model\PaymentIntent

Payment Links

Generate and manage payment links for easy customer payments.

Methods

`paymentLinksControllerCreate($create_payment_link_dto)`

Create a new payment link.

<?php
use Devdraft\Api\PaymentLinksApi;
use Devdraft\Model\CreatePaymentLinkDto;
use GuzzleHttp\Client;

$apiInstance = new PaymentLinksApi(new Client(), $config);

try {
    $linkDto = new CreatePaymentLinkDto([
        'name' => 'Product Purchase',
        'amount' => 99.99,
        'currency' => 'USD',
        'products' => [
            [
                'name' => 'Premium Plan',
                'quantity' => 1,
                'price' => 99.99
            ]
        ]
    ]);
    
    $link = $apiInstance->paymentLinksControllerCreate($linkDto);
    echo "Payment link: " . $link->getUrl() . "\n";
    echo "Share this link with customers: " . $link->getShortUrl() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_payment_link_dto: \Devdraft\Model\CreatePaymentLinkDto - Link details

Returns: \Devdraft\Model\PaymentLink

`paymentLinksControllerFindAll($page, $limit, $active)`

Get all payment links.

$links = $apiInstance->paymentLinksControllerFindAll(1, 20, true);

foreach ($links as $link) {
    echo $link->getName() . ": " . $link->getUrl() . "\n";
}

Parameters:

$page: int - Page number (optional)
$limit: int - Items per page (optional)
$active: bool - Filter by active status (optional)

Returns: \Devdraft\Model\PaymentLink[]

`paymentLinksControllerFindOne($id)`

Get a payment link by ID.

$link = $apiInstance->paymentLinksControllerFindOne('link-id');
echo "Link: " . $link->getUrl() . "\n";

Parameters:

$id: string - Payment link ID

Returns: \Devdraft\Model\PaymentLink

`paymentLinksControllerUpdate($id, $update_payment_link_dto)`

Update a payment link.

$updateDto = [
    'active' => false,
    'expires_at' => '2024-12-31T23:59:59Z'
];

$updated = $apiInstance->paymentLinksControllerUpdate('link-id', $updateDto);
echo "Link updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Payment link ID
$update_payment_link_dto: array - Fields to update

Returns: \Devdraft\Model\PaymentLink

Products

Manage your product catalog.

Methods

`productControllerCreate($create_product_dto)`

Create a new product.

<?php
use Devdraft\Api\ProductsApi;
use GuzzleHttp\Client;

$apiInstance = new ProductsApi(new Client(), $config);

try {
    $productDto = [
        'name' => 'Premium Subscription',
        'description' => 'Access to all premium features',
        'price' => 99.99,
        'currency' => 'USD',
        'category' => 'subscriptions'
    ];
    
    $product = $apiInstance->productControllerCreate($productDto);
    echo "Product created: " . $product->getId() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_product_dto: array - Product details

Returns: \Devdraft\Model\Product

`productControllerFindAll($category, $active)`

Get all products.

$products = $apiInstance->productControllerFindAll('subscriptions', true);

foreach ($products as $product) {
    echo $product->getName() . ": $" . $product->getPrice() . "\n";
}

Parameters:

$category: string - Filter by category (optional)
$active: bool - Filter by active status (optional)

Returns: \Devdraft\Model\Product[]

`productControllerFindOne($id)`

Get a product by ID.

$product = $apiInstance->productControllerFindOne('product-id');
echo "Product: " . $product->getName() . "\n";

Parameters:

$id: string - Product ID

Returns: \Devdraft\Model\Product

`productControllerUpdate($id, $update_product_dto)`

Update a product.

$updateDto = [
    'price' => 89.99,
    'description' => 'Updated description'
];

$updated = $apiInstance->productControllerUpdate('product-id', $updateDto);
echo "Product updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Product ID
$update_product_dto: array - Fields to update

Returns: \Devdraft\Model\Product

`productControllerRemove($id)`

Delete a product.

$apiInstance->productControllerRemove('product-id');
echo "Product deleted\n";

Parameters:

$id: string - Product ID

Returns: void

`productControllerUploadImage($id, $images)`

Upload images for a product.

$images = [
    new \SplFileObject('/path/to/image1.jpg'),
    new \SplFileObject('/path/to/image2.jpg')
];

$product = $apiInstance->productControllerUploadImage('product-id', $images);
echo "Images uploaded for product: " . $product->getId() . "\n";

Parameters:

$id: string - Product ID
$images: \SplFileObject[] - Image files

Returns: \Devdraft\Model\Product

Taxes

Configure and manage tax settings.

Methods

`taxControllerCreate($create_tax_dto)`

Create a new tax configuration.

<?php
use Devdraft\Api\TaxesApi;
use Devdraft\Model\CreateTaxDto;
use GuzzleHttp\Client;

$apiInstance = new TaxesApi(new Client(), $config);

try {
    $taxDto = new CreateTaxDto([
        'name' => 'Sales Tax',
        'percentage' => 8.5,
        'country' => 'US',
        'state' => 'CA'
    ]);
    
    $tax = $apiInstance->taxControllerCreate($taxDto);
    echo "Tax created: " . $tax->getId() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_tax_dto: \Devdraft\Model\CreateTaxDto - Tax details

Returns: \Devdraft\Model\Tax

`taxControllerFindAll($country)`

Get all tax configurations.

$taxes = $apiInstance->taxControllerFindAll('US');

foreach ($taxes as $tax) {
    echo $tax->getName() . ": " . $tax->getPercentage() . "%\n";
}

Parameters:

$country: string - Filter by country (optional)

Returns: \Devdraft\Model\Tax[]

`taxControllerFindOne($id)`

Get a tax configuration by ID.

$tax = $apiInstance->taxControllerFindOne('tax-id');
echo "Tax: " . $tax->getName() . "\n";

Parameters:

$id: string - Tax ID

Returns: \Devdraft\Model\Tax

`taxControllerUpdate($id, $update_tax_dto)`

Update a tax configuration.

use Devdraft\Model\UpdateTaxDto;

$updateDto = new UpdateTaxDto(['percentage' => 9.0]);
$updated = $apiInstance->taxControllerUpdate('tax-id', $updateDto);
echo "Tax updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Tax ID
$update_tax_dto: \Devdraft\Model\UpdateTaxDto - Fields to update

Returns: \Devdraft\Model\Tax

`taxControllerRemove($id)`

Delete a tax configuration.

$apiInstance->taxControllerRemove('tax-id');
echo "Tax deleted\n";

Parameters:

$id: string - Tax ID

Returns: void

Test Payments

Process test payments in sandbox environment.

Methods

`testPaymentControllerCreatePaymentV0($payment_request_dto)`

Create a test payment.

<?php
use Devdraft\Api\TestPaymentsApi;
use Devdraft\Model\PaymentRequestDto;
use GuzzleHttp\Client;

$apiInstance = new TestPaymentsApi(new Client(), $config);

try {
    $paymentDto = new PaymentRequestDto([
        'amount' => 100.00,
        'currency' => 'USD',
        'customer_id' => 'test-customer-id',
        'idempotency_key' => 'unique-key-123'
    ]);
    
    $payment = $apiInstance->testPaymentControllerCreatePaymentV0($paymentDto);
    echo "Test payment: " . $payment->getId() . "\n";
    echo "Status: " . $payment->getStatus() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$payment_request_dto: \Devdraft\Model\PaymentRequestDto - Payment details

Returns: \Devdraft\Model\PaymentResponseDto

`testPaymentControllerGetPaymentV0($id)`

Get test payment details by ID.

$payment = $apiInstance->testPaymentControllerGetPaymentV0('payment-id');
echo "Payment status: " . $payment->getStatus() . "\n";

Parameters:

$id: string - Payment ID

Returns: \Devdraft\Model\PaymentResponseDto

`testPaymentControllerRefundPaymentV0($id, $refund_amount)`

Refund a test payment.

$refund = $apiInstance->testPaymentControllerRefundPaymentV0('payment-id', 50.00);
echo "Refund processed: " . $refund->getId() . "\n";

Parameters:

$id: string - Payment ID
$refund_amount: float - Amount to refund (optional, defaults to full amount)

Returns: \Devdraft\Model\RefundResponseDto

Transfers

Initiate and manage fund transfers between different payment rails.

Methods

`transferControllerCreateDirectBankTransfer($create_direct_bank_transfer_dto)`

Create a direct bank transfer.

<?php
use Devdraft\Api\TransfersApi;
use Devdraft\Model\CreateDirectBankTransferDto;
use GuzzleHttp\Client;

$apiInstance = new TransfersApi(new Client(), $config);

try {
    $transferDto = new CreateDirectBankTransferDto([
        'wallet_id' => 'wallet-id',
        'payment_rail' => 'wire',
        'source_currency' => 'usd',
        'destination_currency' => 'usdc',
        'amount' => 1000.00
    ]);
    
    $transfer = $apiInstance->transferControllerCreateDirectBankTransfer($transferDto);
    echo "Transfer created: " . $transfer->getId() . "\n";
    echo "Bank instructions: " . print_r($transfer->getSourceDepositInstructions(), true) . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_direct_bank_transfer_dto: \Devdraft\Model\CreateDirectBankTransferDto - Transfer details

Returns: \Devdraft\Model\Transfer See also: Direct Bank Transfer Guide

`transferControllerCreateDirectWalletTransfer($create_direct_wallet_transfer_dto)`

Create a direct wallet transfer.

use Devdraft\Model\CreateDirectWalletTransferDto;

$transferDto = new CreateDirectWalletTransferDto([
    'wallet_id' => 'wallet-id',
    'network' => 'solana',
    'stable_coin_currency' => 'usdc',
    'amount' => 500.00
]);

$transfer = $apiInstance->transferControllerCreateDirectWalletTransfer($transferDto);
echo "Transfer created: " . $transfer->getId() . "\n";
echo "Deposit address: " . $transfer->getSourceDepositInstructions()->getToAddress() . "\n";

Parameters:

$create_direct_wallet_transfer_dto: \Devdraft\Model\CreateDirectWalletTransferDto - Transfer details

Returns: \Devdraft\Model\Transfer See also: Direct Wallet Transfer Guide

`transferControllerCreateExternalBankTransfer($create_external_bank_transfer_dto)`

Create an external bank transfer (from your wallet to external bank).

use Devdraft\Model\CreateExternalBankTransferDto;

$transferDto = new CreateExternalBankTransferDto([
    'source_wallet_id' => 'wallet-id',
    'destination_bank_account_id' => 'bank-account-id',
    'amount' => 1000.00,
    'currency' => 'USD'
]);

$transfer = $apiInstance->transferControllerCreateExternalBankTransfer($transferDto);
echo "External bank transfer: " . $transfer->getId() . "\n";

Parameters:

$create_external_bank_transfer_dto: \Devdraft\Model\CreateExternalBankTransferDto - Transfer details

Returns: \Devdraft\Model\Transfer

`transferControllerCreateExternalStablecoinTransfer($create_external_stablecoin_transfer_dto)`

Create an external stablecoin transfer (from your wallet to external wallet).

use Devdraft\Model\CreateExternalStablecoinTransferDto;

$transferDto = new CreateExternalStablecoinTransferDto([
    'source_wallet_id' => 'wallet-id',
    'destination_address' => '0x742d35Cc6Ff82a8C2D8D1Da9da17c7eDfD5bE0a3',
    'network' => 'ethereum',
    'currency' => 'usdc',
    'amount' => 250.00
]);

$transfer = $apiInstance->transferControllerCreateExternalStablecoinTransfer($transferDto);
echo "External stablecoin transfer: " . $transfer->getId() . "\n";

Parameters:

$create_external_stablecoin_transfer_dto: \Devdraft\Model\CreateExternalStablecoinTransferDto - Transfer details

Returns: \Devdraft\Model\Transfer

`transferControllerCreateStablecoinConversion($create_stablecoin_conversion_dto)`

Convert between different stablecoins or networks.

use Devdraft\Model\CreateStablecoinConversionDto;

$conversionDto = new CreateStablecoinConversionDto([
    'source_wallet_id' => 'wallet-id',
    'destination_wallet_id' => 'wallet-id',
    'source_network' => 'ethereum',
    'destination_network' => 'solana',
    'source_currency' => 'usdc',
    'destination_currency' => 'usdc',
    'amount' => 1000.00
]);

$conversion = $apiInstance->transferControllerCreateStablecoinConversion($conversionDto);
echo "Conversion ID: " . $conversion->getId() . "\n";
echo "Exchange rate: " . $conversion->getExchangeRate()->getRate() . "\n";
echo "Estimated completion: " . $conversion->getEstimatedCompletion() . "\n";

Parameters:

$create_stablecoin_conversion_dto: \Devdraft\Model\CreateStablecoinConversionDto - Conversion details

Returns: \Devdraft\Model\Conversion See also: Stablecoin Conversion Guide

Wallets

Manage wallets and query balances.

Methods

`walletControllerGetWallets()`

Get all wallets for your application.

<?php
use Devdraft\Api\WalletsApi;
use GuzzleHttp\Client;

$apiInstance = new WalletsApi(new Client(), $config);

try {
    $apiInstance->walletControllerGetWallets();
    echo "Wallets retrieved successfully\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Returns: void

The response contains wallet IDs that you can use for transfers and other operations. In a future SDK version, this will return typed wallet objects.

Webhooks

Configure webhooks to receive real-time event notifications.

Methods

`webhookControllerCreate($create_webhook_dto)`

Create a new webhook.

<?php
use Devdraft\Api\WebhooksApi;
use Devdraft\Model\CreateWebhookDto;
use GuzzleHttp\Client;

$apiInstance = new WebhooksApi(new Client(), $config);

try {
    $webhookDto = new CreateWebhookDto([
        'url' => 'https://your-app.com/webhooks/devdraft',
        'name' => 'Production Webhook',
        'is_active' => true,
        'encrypted' => false
    ]);
    
    $webhook = $apiInstance->webhookControllerCreate($webhookDto);
    echo "Webhook ID: " . $webhook->getId() . "\n";
    echo "Signing secret: " . $webhook->getSigningSecret() . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

Parameters:

$create_webhook_dto: \Devdraft\Model\CreateWebhookDto - Webhook configuration

Returns: \Devdraft\Model\WebhookResponseDto See also: Webhooks Overview

`webhookControllerFindAll($page, $limit, $active)`

Get all webhooks.

$webhooks = $apiInstance->webhookControllerFindAll(1, 20, true);

foreach ($webhooks as $webhook) {
    echo $webhook->getName() . ": " . $webhook->getUrl() . "\n";
    echo "Active: " . ($webhook->getIsActive() ? 'Yes' : 'No') . "\n";
}

Parameters:

$page: int - Page number (optional)
$limit: int - Items per page (optional)
$active: bool - Filter by active status (optional)

Returns: \Devdraft\Model\WebhookResponseDto[]

`webhookControllerFindOne($id)`

Get a webhook by ID.

$webhook = $apiInstance->webhookControllerFindOne('webhook-id');

echo "Webhook: " . $webhook->getName() . "\n";
echo "URL: " . $webhook->getUrl() . "\n";
echo "Delivery stats: " . print_r($webhook->getDeliveryStats(), true) . "\n";

Parameters:

$id: string - Webhook ID

Returns: \Devdraft\Model\WebhookResponseDto

`webhookControllerUpdate($id, $update_webhook_dto)`

Update a webhook.

use Devdraft\Model\UpdateWebhookDto;

$updateDto = new UpdateWebhookDto([
    'url' => 'https://your-app.com/webhooks/new-endpoint',
    'is_active' => true
]);

$updated = $apiInstance->webhookControllerUpdate('webhook-id', $updateDto);
echo "Webhook updated: " . $updated->getId() . "\n";

Parameters:

$id: string - Webhook ID
$update_webhook_dto: \Devdraft\Model\UpdateWebhookDto - Fields to update

Returns: \Devdraft\Model\WebhookResponseDto

`webhookControllerRemove($id)`

Delete a webhook.

$apiInstance->webhookControllerRemove('webhook-id');
echo "Webhook deleted\n";

Parameters:

$id: string - Webhook ID

Returns: void

Error Handling

All SDK methods throw exceptions on errors. Handle them appropriately:

<?php
use Devdraft\ApiException;

try {
    $transfer = $apiInstance->transferControllerCreateDirectWalletTransfer($transferDto);
    echo "Transfer created: " . $transfer->getId() . "\n";
} catch (ApiException $e) {
    $statusCode = $e->getCode();
    $responseBody = $e->getResponseBody();
    
    switch ($statusCode) {
        case 400:
            echo "Invalid request: " . $e->getMessage() . "\n";
            break;
        case 401:
            echo "Authentication failed - check your API credentials\n";
            break;
        case 404:
            echo "Resource not found: " . $e->getMessage() . "\n";
            break;
        case 422:
            echo "Validation error: " . $e->getMessage() . "\n";
            break;
        case 429:
            $retryAfter = $e->getResponseHeaders()['Retry-After'] ?? 'unknown';
            echo "Rate limited - retry after: $retryAfter\n";
            break;
        default:
            echo "API error ($statusCode): " . $e->getMessage() . "\n";
    }
    
    // Log full response for debugging
    error_log("Response body: " . print_r($responseBody, true));
} catch (Exception $e) {
    echo "Unexpected error: " . $e->getMessage() . "\n";
}

Best Practices

Use Environment Variables for Credentials

Store API credentials in environment variables, never in source code.

<?php
$config = Devdraft\Configuration::getDefaultConfiguration()
    ->setApiKey('x-client-key', getenv('DEVDRAFT_CLIENT_KEY'))
    ->setApiKey('x-client-secret', getenv('DEVDRAFT_CLIENT_SECRET'));

Reuse Configuration and Client Instances

Create a single configuration and reuse it across your application.

<?php
// Bad: Creating new instances for each request
function processTransfer() {
    $config = Devdraft\Configuration::getDefaultConfiguration()
        ->setApiKey('x-client-key', getenv('DEVDRAFT_CLIENT_KEY'))
        ->setApiKey('x-client-secret', getenv('DEVDRAFT_CLIENT_SECRET'));
    $client = new GuzzleHttp\Client();
    $api = new Devdraft\Api\TransfersApi($client, $config);
    // use api...
}

// Good: Reuse configuration and client
class DevdraftService {
    private $transfersApi;
    
    public function __construct() {
        $config = Devdraft\Configuration::getDefaultConfiguration()
            ->setApiKey('x-client-key', getenv('DEVDRAFT_CLIENT_KEY'))
            ->setApiKey('x-client-secret', getenv('DEVDRAFT_CLIENT_SECRET'));
        
        $client = new GuzzleHttp\Client();
        $this->transfersApi = new Devdraft\Api\TransfersApi($client, $config);
    }
    
    public function processTransfer($transferDto) {
        return $this->transfersApi->transferControllerCreateDirectWalletTransfer($transferDto);
    }
}

Proper Exception Handling

Always wrap API calls in try-catch blocks and handle errors appropriately.

<?php
use Devdraft\ApiException;

try {
    $result = $apiInstance->someMethod($dto);
    // Process result
} catch (ApiException $e) {
    // Log error details
    error_log(sprintf(
        "API Error: %s (Code: %d, Response: %s)",
        $e->getMessage(),
        $e->getCode(),
        json_encode($e->getResponseBody())
    ));
    
    // Handle specific error codes
    if ($e->getCode() === 429) {
        // Implement retry logic
    }
} catch (Exception $e) {
    error_log("Unexpected error: " . $e->getMessage());
}

Use Type Hints

Leverage PHP’s type hints for better code quality and IDE support.

<?php
use Devdraft\Model\CreateDirectWalletTransferDto;
use Devdraft\Model\Transfer;

function createTransfer(string $walletId, float $amount): Transfer {
    $transferDto = new CreateDirectWalletTransferDto([
        'wallet_id' => $walletId,
        'network' => 'solana',
        'stable_coin_currency' => 'usdc',
        'amount' => $amount
    ]);
    
    return $apiInstance->transferControllerCreateDirectWalletTransfer($transferDto);
}

Validate Input Data

Validate input data before making API calls to catch errors early.

<?php
function createCustomer(array $data): void {
    // Validate required fields
    $required = ['first_name', 'last_name', 'email'];
    foreach ($required as $field) {
        if (empty($data[$field])) {
            throw new InvalidArgumentException("Missing required field: $field");
        }
    }
    
    // Validate email format
    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        throw new InvalidArgumentException("Invalid email format");
    }
    
    // Create customer
    $customerDto = new CreateCustomerDto($data);
    $apiInstance->customerControllerCreate($customerDto);
}

Implement Logging

Use PSR-3 compatible logging for debugging and monitoring.

<?php
use Psr\Log\LoggerInterface;
use Devdraft\ApiException;

class DevdraftService {
    private $logger;
    private $transfersApi;
    
    public function __construct(LoggerInterface $logger, TransfersApi $transfersApi) {
        $this->logger = $logger;
        $this->transfersApi = $transfersApi;
    }
    
    public function createTransfer(CreateDirectWalletTransferDto $dto): Transfer {
        $this->logger->info('Creating transfer', ['wallet_id' => $dto->getWalletId()]);
        
        try {
            $transfer = $this->transfersApi->transferControllerCreateDirectWalletTransfer($dto);
            $this->logger->info('Transfer created', ['transfer_id' => $transfer->getId()]);
            return $transfer;
        } catch (ApiException $e) {
            $this->logger->error('Transfer creation failed', [
                'error' => $e->getMessage(),
                'code' => $e->getCode(),
                'response' => $e->getResponseBody()
            ]);
            throw $e;
        }
    }
}

Testing with PHPUnit

Example PHPUnit test for SDK integration:

<?php
use PHPUnit\Framework\TestCase;
use Devdraft\Configuration;
use Devdraft\Api\WebhooksApi;
use Devdraft\Model\CreateWebhookDto;
use GuzzleHttp\Client;

class WebhookTest extends TestCase
{
    private $config;
    private $apiInstance;
    
    protected function setUp(): void
    {
        $this->config = Configuration::getDefaultConfiguration()
            ->setApiKey('x-client-key', getenv('DEVDRAFT_TEST_CLIENT_KEY'))
            ->setApiKey('x-client-secret', getenv('DEVDRAFT_TEST_CLIENT_SECRET'));
        
        $this->apiInstance = new WebhooksApi(new Client(), $this->config);
    }
    
    public function testCreateWebhook(): void
    {
        $webhookDto = new CreateWebhookDto([
            'url' => 'https://test.example.com/webhook',
            'name' => 'Test Webhook',
            'is_active' => true
        ]);
        
        $webhook = $this->apiInstance->webhookControllerCreate($webhookDto);
        
        $this->assertNotNull($webhook->getId());
        $this->assertEquals('Test Webhook', $webhook->getName());
        $this->assertTrue($webhook->getIsActive());
    }
    
    public function testInvalidWebhookUrl(): void
    {
        $this->expectException(\Devdraft\ApiException::class);
        
        $webhookDto = new CreateWebhookDto([
            'url' => 'invalid-url',
            'name' => 'Invalid Webhook',
            'is_active' => true
        ]);
        
        $this->apiInstance->webhookControllerCreate($webhookDto);
    }
}

Laravel Integration

Example Laravel service provider for Devdraft SDK:

<?php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Devdraft\Configuration;
use Devdraft\Api\TransfersApi;
use Devdraft\Api\WebhooksApi;
use GuzzleHttp\Client;

class DevdraftServiceProvider extends ServiceProvider
{
    public function register()
    {
        $this->app->singleton(Configuration::class, function ($app) {
            return Configuration::getDefaultConfiguration()
                ->setApiKey('x-client-key', config('services.devdraft.client_key'))
                ->setApiKey('x-client-secret', config('services.devdraft.client_secret'))
                ->setHost(config('services.devdraft.api_url', 'https://api.devdraft.ai'));
        });
        
        $this->app->singleton(Client::class, function ($app) {
            return new Client();
        });
        
        $this->app->singleton(TransfersApi::class, function ($app) {
            return new TransfersApi(
                $app->make(Client::class),
                $app->make(Configuration::class)
            );
        });
        
        $this->app->singleton(WebhooksApi::class, function ($app) {
            return new WebhooksApi(
                $app->make(Client::class),
                $app->make(Configuration::class)
            );
        });
    }
}

Usage in Laravel controller:

<?php
namespace App\Http\Controllers;

use Devdraft\Api\TransfersApi;
use Devdraft\Model\CreateDirectWalletTransferDto;
use Illuminate\Http\Request;

class TransferController extends Controller
{
    private $transfersApi;
    
    public function __construct(TransfersApi $transfersApi)
    {
        $this->transfersApi = $transfersApi;
    }
    
    public function create(Request $request)
    {
        $validated = $request->validate([
            'wallet_id' => 'required|string',
            'amount' => 'required|numeric|min:0.01',
        ]);
        
        try {
            $transferDto = new CreateDirectWalletTransferDto([
                'wallet_id' => $validated['wallet_id'],
                'network' => 'solana',
                'stable_coin_currency' => 'usdc',
                'amount' => $validated['amount']
            ]);
            
            $transfer = $this->transfersApi->transferControllerCreateDirectWalletTransfer($transferDto);
            
            return response()->json([
                'success' => true,
                'transfer_id' => $transfer->getId()
            ]);
        } catch (\Devdraft\ApiException $e) {
            return response()->json([
                'success' => false,
                'error' => $e->getMessage()
            ], $e->getCode());
        }
    }
}

Next Steps

SDK Quickstart

Complete integration guide with examples

Transfers

Learn about initiating transfers

Webhooks

Set up webhook notifications

API Reference

Complete REST API documentation

Getting Started

SDK References

​Overview

PSR-7 Compatible

Composer Support

Comprehensive

Modern PHP

​Installation

​Using Composer

​Requirements

​Quick Start

​API Classes

​API Health

​Methods

​healthControllerCheckV0()

​healthControllerPublicHealthCheckV0()

​App Balances

​Methods

​balanceControllerGetAllBalances()

​balanceControllerGetUSDCBalance()

​balanceControllerGetEURCBalance()

​Customers

​Methods

​customerControllerCreate($create_customer_dto)

​customerControllerFindAll($page, $limit, $status)

​customerControllerFindOne($id)

​customerControllerUpdate($id, $update_customer_dto)

​Exchange Rates

​Methods

​exchangeRateControllerGetExchangeRate($from, $to)

​exchangeRateControllerGetUSDToEURRate()

​exchangeRateControllerGetEURToUSDRate()

​Invoices

​Methods

​invoiceControllerCreate($create_invoice_dto)

​invoiceControllerFindAll($page, $limit, $status)

​invoiceControllerFindOne($id)

​invoiceControllerUpdate($id, $update_invoice_dto)

​Liquidation Addresses

​Methods

​liquidationAddressControllerCreateLiquidationAddress($customer_id, $create_liquidation_address_dto)

​liquidationAddressControllerGetLiquidationAddresses($customer_id)

​liquidationAddressControllerGetLiquidationAddress($customer_id, $liquidation_address_id)

​Payment Intents

​Methods

​paymentIntentControllerCreateBankPaymentIntent($create_bank_payment_intent_dto)

​paymentIntentControllerCreateStablePaymentIntent($create_stable_payment_intent_dto)

​Payment Links

​Methods

​paymentLinksControllerCreate($create_payment_link_dto)

​paymentLinksControllerFindAll($page, $limit, $active)

​paymentLinksControllerFindOne($id)

​paymentLinksControllerUpdate($id, $update_payment_link_dto)

​Products

​Methods

​productControllerCreate($create_product_dto)

​productControllerFindAll($category, $active)

​productControllerFindOne($id)

​productControllerUpdate($id, $update_product_dto)

​productControllerRemove($id)

​productControllerUploadImage($id, $images)

​Taxes

​Methods

​taxControllerCreate($create_tax_dto)

​taxControllerFindAll($country)

​taxControllerFindOne($id)

​taxControllerUpdate($id, $update_tax_dto)

​taxControllerRemove($id)

​Test Payments

​Methods

​testPaymentControllerCreatePaymentV0($payment_request_dto)

​testPaymentControllerGetPaymentV0($id)

​testPaymentControllerRefundPaymentV0($id, $refund_amount)

​Transfers

​Methods

​transferControllerCreateDirectBankTransfer($create_direct_bank_transfer_dto)

​transferControllerCreateDirectWalletTransfer($create_direct_wallet_transfer_dto)

​transferControllerCreateExternalBankTransfer($create_external_bank_transfer_dto)

​transferControllerCreateExternalStablecoinTransfer($create_external_stablecoin_transfer_dto)

​transferControllerCreateStablecoinConversion($create_stablecoin_conversion_dto)

Overview

Installation

Using Composer

Requirements

Quick Start

API Classes

API Health

Methods

`healthControllerCheckV0()`

`healthControllerPublicHealthCheckV0()`

App Balances

Methods

`balanceControllerGetAllBalances()`

`balanceControllerGetUSDCBalance()`

`balanceControllerGetEURCBalance()`

Customers

Methods

`customerControllerCreate($create_customer_dto)`

`customerControllerFindAll($page, $limit, $status)`

`customerControllerFindOne($id)`

`customerControllerUpdate($id, $update_customer_dto)`

Exchange Rates

Methods

`exchangeRateControllerGetExchangeRate($from, $to)`

`exchangeRateControllerGetUSDToEURRate()`

`exchangeRateControllerGetEURToUSDRate()`

Invoices

Methods

`invoiceControllerCreate($create_invoice_dto)`

`invoiceControllerFindAll($page, $limit, $status)`

`invoiceControllerFindOne($id)`

`invoiceControllerUpdate($id, $update_invoice_dto)`

Liquidation Addresses

Methods

`liquidationAddressControllerCreateLiquidationAddress($customer_id, $create_liquidation_address_dto)`

`liquidationAddressControllerGetLiquidationAddresses($customer_id)`

`liquidationAddressControllerGetLiquidationAddress($customer_id, $liquidation_address_id)`

Payment Intents

Methods

`paymentIntentControllerCreateBankPaymentIntent($create_bank_payment_intent_dto)`

`paymentIntentControllerCreateStablePaymentIntent($create_stable_payment_intent_dto)`

Payment Links

Methods

`paymentLinksControllerCreate($create_payment_link_dto)`

`paymentLinksControllerFindAll($page, $limit, $active)`

`paymentLinksControllerFindOne($id)`

`paymentLinksControllerUpdate($id, $update_payment_link_dto)`

Products

Methods

`productControllerCreate($create_product_dto)`

`productControllerFindAll($category, $active)`

`productControllerFindOne($id)`

`productControllerUpdate($id, $update_product_dto)`

`productControllerRemove($id)`

`productControllerUploadImage($id, $images)`

Taxes

Methods

`taxControllerCreate($create_tax_dto)`

`taxControllerFindAll($country)`

`taxControllerFindOne($id)`

`taxControllerUpdate($id, $update_tax_dto)`

`taxControllerRemove($id)`

Test Payments

Methods

`testPaymentControllerCreatePaymentV0($payment_request_dto)`

`testPaymentControllerGetPaymentV0($id)`

`testPaymentControllerRefundPaymentV0($id, $refund_amount)`

Transfers

Methods

`transferControllerCreateDirectBankTransfer($create_direct_bank_transfer_dto)`

`transferControllerCreateDirectWalletTransfer($create_direct_wallet_transfer_dto)`

`transferControllerCreateExternalBankTransfer($create_external_bank_transfer_dto)`

`transferControllerCreateExternalStablecoinTransfer($create_external_stablecoin_transfer_dto)`

`transferControllerCreateStablecoinConversion($create_stablecoin_conversion_dto)`

Wallets

Methods

`walletControllerGetWallets()`

Webhooks

Methods

`webhookControllerCreate($create_webhook_dto)`