openssl req -x509 -newkey rsa:4096 -keyout tests/resource/key.pem -out tests/resource/certificate.cert -days 365 -nodes -subj '/CN=Your App Id/C=NL'

vendor/phpunit/phpunit/phpunit

$ composer require bunq/sdk_php

$ vendor/bin/bunq-install

use bunq\Context\ApiContext;
use bunq\Util\BunqEnumApiEnvironmentType;
use bunq\Util\InstallationUtil;

// Automatically install and save the API context
InstallationUtil::automaticInstall(
    BunqEnumApiEnvironmentType::SANDBOX(), // Use PRODUCTION() for production
    '/path/to/save/context.conf'
);

use bunq\Context\BunqContext;

BunqContext::loadApiContext(
    ApiContext::restore('/path/to/saved/context.conf')
);

$apiContext = ApiContext::createForPsd2(
    BunqEnumApiEnvironmentType::SANDBOX(), // Could be PRODUCTION as well.
    SecurityUtil::getCertificateFromFile($pathToCertificate),
    SecurityUtil::getPrivateKeyFromFile($pathToKey),
    [
        SecurityUtil::getCertificateFromFile($pathToCertificateInChain), // Could be one file containing chain, or multiple certificate files in array.
    ],
    $description
)

$proxyUrl = 'socks5://localhost:1080'; // The proxy for all requests, null to disable

$apiContext = ApiContext::create(
    ...
    $proxyUrl
);

use bunq\Model\Generated\Endpoint\MonetaryAccountBankApiObject;

$accountId = MonetaryAccountBankApiObject::create(
    'EUR',                     // Currency
    'My account description'   // Description
)->getValue();

$monetaryAccount = MonetaryAccountBankApiObject::get($accountId)->getValue();

MonetaryAccountBankApiObject::update(    
    $accountId,    
    null,      // New description (null = no change)    
    null,      // Avatar (null = no change)    
    null,      // Status (null = no change)    
    'CANCELLED',  // Status    
    'REDEMPTION_VOLUNTARY',  // Sub-status    
    'OTHER',   // Reason    
    'Closing this test account'  // Reason description
);

use bunq\Model\Generated\Endpoint\PaymentApiObject;
use bunq\Model\Generated\Object\AmountObject;
use bunq\Model\Generated\Object\PointerObject;

// Create payment to another user
$payment = PaymentApiObject::create(
    new AmountObject('0.01', 'EUR'),  // Amount and currency    
    new PointerObject('EMAIL', '[email protected]'),  // Recipient    
    'Payment description'  // Description
);

// Get the IBAN pointer of the recipient account
$recipientAccountAlias = $monetaryAccount->getAlias()[0]; // Get the first alias
$paymentId = PaymentApiObject::create(
    new AmountObject('0.01', 'EUR'),    
    $recipientAccountAlias,    
    'Payment description'
);

use bunq\Model\Generated\Endpoint\PaymentBatchApiObject;

// Create an array of payments
$payments = [];for ($i = 0; $i < 10; $i++) {
    $payment = new PaymentApiObject(
            new AmountObject('0.01', 'EUR'),
            new PointerObject('EMAIL', '[email protected]'),        
            'Batch payment #' . $i    
    );    
    $payments[] = $payment;
}

// Create the batch payment
$batchId = PaymentBatchApiObject::create($payments)->getValue();

use bunq\Model\Generated\Endpoint\RequestInquiryApiObject;

$requestId = RequestInquiryApiObject::create(
    new AmountObject('0.01', 'EUR'),    
    new PointerObject('EMAIL', '[email protected]'),    
    'Request description',    
    false  // Don't allow bunqme
)->getValue();

use bunq\Model\Generated\Endpoint\RequestResponseApiObject;

// List responses to find the ID
$responses = RequestResponseApiObject::listing($monetaryAccountId)->getValue();
$requestResponseId = $responses[0]->getId();

// Accept the request
RequestResponseApiObject::update(
    $requestResponseId,
    $monetaryAccountId,    
    null,    
    'ACCEPTED'  // Status
);

use bunq\Model\Generated\Endpoint\BunqMeTabApiObject;
use bunq\Model\Generated\Endpoint\BunqMeTabEntryApiObject;

$tabId = BunqMeTabApiObject::create(
    new BunqMeTabEntryApiObject(
            new AmountObject('0.01', 'EUR'),        
            'Tab description'    
    )
)->getValue();

// Get tab details
$tab = BunqMeTabApiObject::get($tabId);

use bunq\Http\ApiClient;
use bunq\Model\Generated\Endpoint\AttachmentPublicApiObject;

// Read the file content
$fileContents = file_get_contents('/path/to/file.png');

// Create the attachment
$attachmentUuid = AttachmentPublicApiObject::create(
    $fileContents,
    [
            ApiClient::HEADER_CONTENT_TYPE => 'image/png',        
            ApiClient::HEADER_ATTACHMENT_DESCRIPTION => 'Attachment description'    
    ]
)->getValue();

use bunq\Model\Generated\Endpoint\AttachmentPublicContentApiObject;

$fileContents = AttachmentPublicContentApiObject::listing($attachmentUuid)->getValue();

use bunq\Model\Generated\Endpoint\AvatarApiObject;

// First create a public attachment
$attachmentUuid = AttachmentPublicApiObject::create(
    $fileContents,    
    [
            ApiClient::HEADER_CONTENT_TYPE => 'image/png',        
            ApiClient::HEADER_ATTACHMENT_DESCRIPTION => 'Avatar image'    
    ]
)->getValue();

// Create the avatar using the attachment
$avatarUuid = AvatarApiObject::create($attachmentUuid)->getValue();

use bunq\Model\Generated\Endpoint\CardNameApiObject;

$cardNamesAllowed = CardNameApiObject::listing()->getValue();
$possibleNames = $cardNamesAllowed[0]->getPossibleCardNameArray();

use bunq\Model\Generated\Endpoint\CardDebitApiObject;
use bunq\Model\Generated\Object\CardPinAssignmentObject;

$cardDebit = CardDebitApiObject::create(
    'My Card',                   // Card description    
    $possibleNames[0],           // Name on card    
    'MASTERCARD',                // Card type    
    'MASTERCARD_DEBIT',          // Product type    
    $userAlias->getName(),       // Second line on card    
    $userAlias,                  // User alias    
    [                           // PIN assignments
            new CardPinAssignmentObject(
                        'PRIMARY',           // PIN assignment type            
                        'MANUAL',            // Routing type            
                        '1234',              // PIN code            
                        $primaryAccountId    // Account ID        
            ),    
    ]
)->getValue();

use bunq\Model\Generated\Endpoint\NotificationFilterUrlMonetaryAccountInternal;
use bunq\Model\Generated\Object\NotificationFilterUrlObject;

$filter = new NotificationFilterUrlObject(
    'MUTATION',                    // Category    
    'https://example.com/callback'  // Callback URL
);

$filters = NotificationFilterUrlMonetaryAccountInternal::createWithListResponse(
    $monetaryAccountId,    
    [$filter]
)->getValue();

use bunq\Model\Generated\Endpoint\NotificationFilterUrlUserInternal;

$filter = new NotificationFilterUrlObject(
    'MUTATION',    
    'https://example.com/callback'
);

$filters = NotificationFilterUrlUserInternal::createWithListResponse(
    [$filter]
)->getValue();

use bunq\Model\Generated\Endpoint\NotificationFilterPushUserInternal;
use bunq\Model\Generated\Object\NotificationFilterPushObject;

$filter = new NotificationFilterPushObject('MUTATION');
$filters = NotificationFilterPushUserInternal::createWithListResponse(
    [$filter]
)->getValue();

use bunq\Model\Core\BunqEnumOauthResponseType;
use bunq\Model\Core\OauthAuthorizationUri;
use bunq\Model\Generated\Endpoint\OauthClientApiObject;

$authUri = OauthAuthorizationUri::create(
    BunqEnumOauthResponseType::CODE(),    
    'https://redirect.example.com',    
    new OauthClientApiObject('client_status'),    
    'state_parameter'
)->getAuthorizationUriString();

use bunq\Model\Generated\Endpoint\SessionApiObject;

SessionApiObject::delete(0);  // 0 refers to the current session

BunqContext::getApiContext()->resetSession();
BunqContext::getApiContext()->save('/path/to/context.conf');

// Get the primary monetary account
$primaryAccount = BunqContext::getUserContext()->getPrimaryMonetaryAccount();

// Get the user alias
$userAlias = null;
if (BunqContext::getUserContext()->isOnlyUserPersonSet()) {
    $userAlias = BunqContext::getUserContext()->getUserPerson()->getAlias()[0];
} elseif (BunqContext::getUserContext()->isOnlyUserCompanySet()) {
    $userAlias = BunqContext::getUserContext()->getUserCompany()->getAlias()[0];
} elseif (BunqContext::getUserContext()->isOnlyUserApiKeySet()) {
    $userAlias = BunqContext::getUserContext()
            ->getUserApiKey()        
            ->getRequestedByUser()        
            ->getReferencedObject()        
            ->getAlias()[0];
}

// Refresh user context
BunqContext::getUserContext()->refreshUserContext();

BunqContext::loadApiContext($apiContext); // if it has not been loaded yet. 

$userCompany = UserCompany::get();

printf($userCompany->getPublicNickName());

BunqContext::loadApiContext($apiContext); // if it has not been loaded yet. 

MonetaryAccountBank::update(
    $monetaryAccount->getId(),
    $description
);

BunqContext::loadApiContext($apiContext); // if it has not been loaded yet. 

CustomerStatementExport::delete($customerStatementExportId);

BunqContext::loadApiContext($apiContext); // if it has not been loaded yet. 

$monetaryAccountList = MonetaryAccount::listing();

foreach ($monetaryAccountList as $monetaryAccount) {
    printf($monetaryAccount->getMonetaryAccountBank->getDescription() . PHP_EOL);
}

<?php
class ApiException extends Exception
{
    /**
     * @var int
     */
    private $responseCode;

    /**
     * @param string $message
     * @param int $responseCode
     */
    public function __construct(string $message, int $responseCode)
    {
        // Some hidden code
    }

    /**
     * @return int
     */
    public function getResponseCode(): int
    {
        return $this->responseCode;
    }
}

<?php
use bunq\Context\ApiContext;
use bunq\Util\BunqEnumApiEnvironmentType;
use bunq\Exception\BadRequestException;


const API_KEY = 'Some invalid API key '; 
const DEVICE_DESCRIPTION = 'This will cause BadRequestException to be thrown.';

try{
    // Make a call that might fail
    $apiContext = ApiContext::create(BunqEnumApiEnvironmentType::SANDBOX(), API_KEY, DEVICE_DESCRIPTION);
} catch (BadRequestException $error){
    // Do something if exception is thrown.
    echo $error->getResponseCode() . PHP_EOL;
    echo $error->getMessage() . PHP_EOL;
}