API Error Codes - HTTP Status Codes and Response Reference

{
  "success": false,
  "error": {
    "code": "invalid_amount",
    "message": "Amount must be greater than 0"
  }
}

$response = $client->payments()->create([...]);

if (!$response['success']) {
    $code = $response['error']['code'];
    $message = $response['error']['message'];
    
    match ($code) {
        'invalid_amount' => handleInvalidAmount(),
        'gateway_unavailable' => retryLater(),
        default => logError($code, $message),
    };
}