Download the PHP package crypto-chiefs/cryptochief-crypto-processing-php without Composer

Crypto Chief PHP SDK — Crypto Processing API Client

Official PHP SDK for the Crypto Chief crypto processing API. Accept crypto payments, send single and mass payouts, sign and broadcast EVM / TRON / Solana / TON / XRP transactions, encode contract calls, manage wallets, and verify webhooks.

• 25 chains across EVM, TRON, Solana, TON, XRP, and the BTC family
• Single + batch payouts, auto-convert swaps, two-phase sign / execute, static deposits, pay-ins, sweeps, withdrawals, fiat ↔ crypto conversion
• High-level helpers: ERC-20 / TRC-20 transfers, ABI-encoded EVM calls, Solana Anchor instructions, TON Jetton / NFT / text-comment transfers
• Local RSA-OAEP / SHA-256 decryption of generated wallet private keys
• Webhook verification + typed event parsing (framework-agnostic)
• PSR-18 HTTP client support (Guzzle by default), strict types, readonly DTOs, backed enums

Installation

Requires PHP 8.1+ with the bcmath, mbstring, openssl, and json extensions.

Quickstart

Mass payout

Funds lock sequentially inside a batch — an intra-batch double-spend cannot occur, even when the total exceeds your balance partway through. Max 50 items per call.

Accept payments (pay-ins / invoices)

A pay-in is an invoice that gives your customer a deposit address (or hosted payment page) and notifies you over webhook when it's paid. Two modes:

• FIAT — you fix the price in fiat (amountFiat + currency); the SDK locks the crypto rate at confirmation time. The customer picks a coin/network at checkout (filter the menu with assets).
• CRYPTO — you fix the crypto amount and the asset up front (amountCrypto + asset).

FIAT invoice ($25 USD, customer picks USDT on any supported network)

The customer opens paymentLink and picks a coin. Once they do, the invoice transitions out of waiting_asset_select and exposes toAddress + paymentCoin + paymentNetwork.

CRYPTO invoice (exact 0.01 ETH on Sepolia)

Lifecycle

Contract calls

The SDK ABI-encodes calldata for you. No more 0xa9059cbb... by hand.

Arbitrary Solidity calls — the SDK reads the signature, computes the Keccak-256 selector, encodes head + tail, and hands you the bytes:

Solana Anchor programs — Borsh has no on-wire type tags, so the SDK forces explicit typing through Borsh::* constructors:

TON — Jetton / NFT / text comment

High-level helpers build the standard TEP-74 / TEP-62 / text-comment bodies. The underlying BoC encoding is delegated to olifanton/interop. For arbitrary contracts use signTonCall(TonCallRequest) with raw BoC bytes.

For a pre-built BoC body (custom contracts), use signTonCall(TonCallRequest) directly with raw bytes.

Wallets

Webhooks

Laravel / Symfony are the same shape — pass the request's raw body to Webhook::parseEvent(). Optionally restrict by source IP: Webhook::SENDER_IPS lists the production webhook IP addresses.

Errors

Every SDK error extends CryptoChiefException, so a single catch covers the library. API failures arrive as ApiException with a stable $errorCode you can branch on:

Only 5xx and network failures retry; 4xx is the caller's fault and surfaces immediately.

Credits balance & top-up

API usage is billed in credits (10 000 000 credits = 1 USD). The balance check itself is free of charge and answers even at zero or negative balance, so it is safe to poll before gas-paying operations (rate-limited to 60 req/min per project):

Top up in USDT or USDC (USD-pegged, max 100 000 per invoice) via a hosted payment page — QR code, network selection, live status. topup() is free of charge too:

Amount precision

Crypto amounts are decimal strings end-to-end. float loses precision past 2^53 and binary rounding bites large token values, so the SDK never uses it for amounts. Convert between human and base units with Amount::humanToBase() / Amount::baseToHuman():

Configuration

httpClient accepts any Psr\Http\Client\ClientInterface. The default is Guzzle 7.

Documentation

• SDK docs: https://docs-sdk.crypto-chief.com/processing/php
• REST API reference: https://docs-processing.crypto-chief.com
• Product page: https://crypto-chief.com/processing/

SDKs for other languages live under the crypto-chiefs GitHub organization.

FAQ — common crypto-processing tasks in PHP

• How do I accept crypto payments in PHP? Open a pay-in via $client->payIns()->create(new CreatePayInRequest(...)). The response carries the paymentLink (and the address once the customer picks a coin).
• How do I send mass payouts in PHP? Call $client->payouts()->batchExecute(new BatchPayoutRequest(items: $items)) with up to 50 recipients. Each item idempotent on its orderId.
• How do I send USDT (TRC-20 / ERC-20 / BEP-20) from PHP? erc20Transfer() — the SDK encodes transfer(address,uint256) and handles TRON base58 addresses transparently.
• How do I send Jettons (USDT on TON, etc.) from PHP? jettonTransfer() — the SDK builds the TEP-74 body, auto-resolves the sender's Jetton wallet via the gateway's TON RPC proxy, and picks the gas budget.
• How do I verify Crypto Chief webhooks in PHP? Webhook::parseEvent($apiKey, $rawBody, $signature) — re-canonicalizes the body, MD5-verifies, and returns a typed event.
• How do I check my API credits balance in PHP? $client->credits()->balance() — free of charge, and canExecuteGasOperations tells you up front whether gas-paying operations would pass the billing gate.
• How do I top up my API credits from PHP? $client->credits()->topup(new CreditsTopupRequest(amount: '250.00', currency: 'USDT')) — returns a hosted paymentLink (QR code, network selection, live status). Also free of charge.
• Does it work with Laravel / Symfony? Yes — the HTTP client is PSR-18 compatible and the webhook verifier takes raw bytes, so it slots into any framework's request body.

License

MIT — see LICENSE.