Basic usage of the PHP SDK
Learn more about the basic usage of the PHP SDK.
Unzer object is the main object that you always require to communicate with the Unzer API (PAPI). Additionally, it is the facade to all functionalities in the PHP SDK.
- methods to perform CRUD operations on the resources (such as payment type, customer, and basket).
- methods that allow transactions such as authorization, charge, cancellation (that is refund and reversal), and shipment.
This means that you have to create the
Unzer object and provide your private key before you can perform tasks with the SDK.
To display potential error messages in the language of the client, you can provide the locale within the second argument of the
Unzer class constructor. For a list of all supported locales, see the Localization page.
$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx');
$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx', 'de-DE');
For some server-side requests, the client’s IP must be manually added.
You can use the
Unzer::setClientIp() method to use the
clientIp. This uses the
clientIp in the header of all the request sent by this instance.
Whenever an authorization or a charge transaction is performed successfully, an instance of the
payment class is automatically created.
payment object contains all information on the payment process and ties all the required resources together. These are some of the information the
payment object stores:
- references to customer and payment type.
- references to transactions, such as charges, authorization, and shipment.
- the amount information, such as total, charged, canceled and remaining
- the currency
- the state of the payment, such as pending, canceled, and completed.
By fetching the
payment object, you can access all information for the complete payment process.
For a full description of the
paymentresource, check the Check payment details page.
In order to perform transactions the API needs to know, which payment type to use. There are two options here:
- reference a payment type that already exists (for example, a registered credit card)
- create and reference a new payment type
The following examples show how to create selected payment types.
$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx'); $card = new UnzerSDK\Resources\PaymentTypes\Card('4711100000000000', '03/20'); $card->setCvc('123'); $card = $unzer->createPaymentType($card);
$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx'); $directDebit = new UnzerSDK\Resources\PaymentTypes\SepaDirectDebit('DE89370400440532013000'); $directDebit = $unzer->createPaymentType($directDebit);
$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx'); $paypal = new UnzerSDK\Resources\PaymentTypes\Paypal(); $paypal = $unzer->createPaymentType($paypal);
You cannot create the Card type with the PHP SDK unless you are PCI compliant.
Please refer Card UI Components integration guide to learn how to use our UI Components to handle card information.
Properties of the Unzer Installment payment type can be updated.
// update Unzer Installment payment type $unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx'); /** @var UnzerSDK\Resources\PaymentTypes\InstallmentSecured $ins */ $ins = $unzer->fetchPaymentType('s-priv-1'); $yesterday = (new \DateTime())->add(\DateInterval::createFromDateString('yesterday')); $ins->setIban('DE89370400440532013000') ->setBic('COBADEFFXXX') ->setAccountHolder('Peter Universum') ->setInvoiceDate($yesterday) ->setInvoiceDueDate($yesterday); $ins = $unzer->updatePaymentType($ins);