<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>YOUR_USERNAME</username>
  <password>SHA1 HASHED PASSWORD</password>
  <debit>
    <transactionId>Your Transaction ID</transactionId>
    <customer>
      <!-- refer to Transaction Data for all available fields -->
      <identification>Customer ID</identification>
      <billingCountry>2-letter country code of your customer</billingCountry>
      <email>email address of your customer</email>
      <ipAddress>127.0.0.1</ipAddress>
    </customer>
    <extraData key="some_key">value_here</extraData>
    <amount>9.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <withRegister>false</withRegister>
  </debit>
</transaction>

<?php
$username = 'Your Username';
$password = 'Your password';
$apiKey = 'Connector API Key';
$sharedSecret = 'Connector Shared Secret';

$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$debit = new \PaymentGateway\Client\Transaction\Debit();
$debit
    ->setTransactionId('Your transaction ID')
    ->setAmount(9.99)
    ->setCurrency('EUR')
    ->setDescription('Your Description')
    ->setSuccessUrl('https://link.to/your/payment-successful-page')
    ->setCancelUrl('https://link.to/your/payment-canceled-page')
    ->setErrorUrl('https://link.to/your/payment-failed-page')
    ->setCallbackUrl('https://link.to/your/notification-handler');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
    ->setFirstName('John')
    ->setLastName('Smith')
    ->setIdentification('The User ID')
    ->setBillingCountry('AT')
    ->setEmail('[email protected]_your_customer.com')
    ->setIpAddress('127.0.0.1');

$debit->setCustomer($customer);

$result = $client->debit($debit);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <debit>
    <transactionId>transaction-00001</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <extraData key="some_key">value_here</extraData>
    <merchantMetaData>my-category-1</merchantMetaData>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <withRegister>false</withRegister>
    <transactionIndicator>SINGLE</transactionIndicator>
  </debit>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$debit = new \PaymentGateway\Client\Transaction\Debit();
$debit
 ->setTransactionId('transaction-00001')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setDescription('Transaction Description')
 ->setSuccessUrl('https://link.to/your/payment-successful-page')
 ->setCancelUrl('https://link.to/your/payment-canceled-page')
 ->setErrorUrl('https://link.to/your/payment-failed-page')
 ->setCallbackUrl('https://link.to/your/notification-handler');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
 ->setFirstName('John')
 ->setLastName('Smith')
 ->setIdentification('1111')
 ->setBillingCountry('AT')
 ->setEmail('[email protected]')
 ->setIpAddress('123.123.123.123');

$debit->setCustomer($customer);

$result = $client->debit($debit);

curl \
-d "PUT_XML_HERE" \
-H "Authorization: Gateway ConnectorKey:Signature" \
-H "Content-Type: text/xml" \
"https://gateway.tillpayments.com/transaction"

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <debit>
    <transactionId>transaction-00002</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <referenceTransactionId>ID-FROM-FIRST-TRANSACTION</referenceTransactionId>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <transactionIndicator>RECURRING</transactionIndicator> <!-- or CARDONFILE -->
  </debit>
</transaction>

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <debit>
    <transactionToken>ix::abcdefghijklmnopqrstuvw</transactionToken>
    <transactionId>transaction-00001</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <withRegister>false</withRegister>
    <transactionIndicator>SINGLE</transactionIndicator> <!-- or INITIAL, if withRegister = true -->
  </debit>
</transaction>

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <preauthorize>
    <transactionId>transaction-00001</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <merchantMetaData>my-category-1</merchantMetaData>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <withRegister>false</withRegister>
  </preauthorize>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$preauth = new \PaymentGateway\Client\Transaction\Preauthorize();
$preauth
 ->setTransactionId('transaction-00001')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setDescription('Transaction Description')
 ->setSuccessUrl('https://link.to/your/payment-successful-page')
 ->setCancelUrl('https://link.to/your/payment-canceled-page')
 ->setErrorUrl('https://link.to/your/payment-failed-page')
 ->setCallbackUrl('https://link.to/your/notification-handler');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
 ->setFirstName('John')
 ->setLastName('Smith')
 ->setIdentification('1111')
 ->setBillingCountry('AT')
 ->setEmail('[email protected]')
 ->setIpAddress('123.123.123.123');

$preauth->setCustomer($customer);

$result = $client->preauthorize($preauth);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <capture>
    <transactionId>transaction-00002</transactionId>
    <referenceTransactionId>uuid_of_preauthorize_transaction</referenceTransactionId>
    <amount>4.99</amount>
    <currency>EUR</currency>
  </capture>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$capture = new \PaymentGateway\Client\Transaction\Capture();
$capture
 ->setTransactionId('transaction-00002')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setReferenceTransactionId('UUID_of_Preauthorize_Transaction');

$result = $client->capture($capture);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <void>
    <transactionId>transaction-00002</transactionId>
    <referenceTransactionId>uuid_of_preauthorize_transaction</referenceTransactionId>
  </void>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$void = new \PaymentGateway\Client\Transaction\VoidTransaction();
$void
 ->setTransactionId('transaction-00002')
 ->setReferenceTransactionId('UUID_of_Preauthorize_Transaction');

$result = $client->void($void);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <refund>
    <transactionId>transaction-00002</transactionId>
    <referenceTransactionId>uuid_of_debit_or_capture_transaction</referenceTransactionId>
    <amount>4.99</amount>
    <currency>EUR</currency>
  </refund>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$refund = new \PaymentGateway\Client\Transaction\Refund();
$refund
 ->setTransactionId('transaction-00002')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setReferenceTransactionId('uuid_of_debit_or_capture_transaction');

$result = $client->refund($refund);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <payout>
    <transactionId>transaction-00001</transactionId>
    <referenceTransactionId>ID-FROM-FIRST-TRANSACTION</referenceTransactionId> <!-- this is optionally, but maybe required for certain methods -->
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
  </payout>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$payout = new \PaymentGateway\Client\Transaction\Payout();
$payout
 ->setTransactionId('transaction-00001')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setDescription('Transaction Description');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
 ->setFirstName('John')
 ->setLastName('Smith')
 ->setIdentification('1111')
 ->setBillingCountry('AT')
 ->setEmail('[email protected]')
 ->setIpAddress('123.123.123.123');

$payout->setCustomer($customer);

$result = $client->payout($payout);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <register>
    <transactionId>transaction-00001</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
  </register>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$register = new \PaymentGateway\Client\Transaction\Register();
$register
 ->setTransactionId('transaction-00001')
 ->setDescription('Transaction Description')
 ->setSuccessUrl('https://link.to/your/payment-successful-page')
 ->setCancelUrl('https://link.to/your/payment-canceled-page')
 ->setErrorUrl('https://link.to/your/payment-failed-page')
 ->setCallbackUrl('https://link.to/your/notification-handler');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
 ->setFirstName('John')
 ->setLastName('Smith')
 ->setIdentification('1111')
 ->setBillingCountry('AT')
 ->setEmail('[email protected]')
 ->setIpAddress('123.123.123.123');

$register->setCustomer($customer);

$result = $client->register($register);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <deregister>
    <transactionId>transaction-00002</transactionId>
    <referenceTransactionId>uuid_of_preauthorize_transaction</referenceTransactionId>
  </deregister>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$deregister = new \PaymentGateway\Client\Transaction\Deregister();
$deregister
 ->setTransactionId('transaction-00002')
 ->setReferenceTransactionId('UUID_of_Register_Transaction');

$result = $client->deregister($deregister);

Request
<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <language>en</language>
  <debit>
    <transactionId>transaction-00001</transactionId>
    <customer>
      <identification>1111</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <billingCountry>AT</billingCountry>
      <email>[email protected]</email>
      <ipAddress>123.123.123.123</ipAddress>
    </customer>
    <amount>9.99</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>
    <withRegister>true</withRegister>
    <startSchedule>
      <amount>4.99</amount>
      <currency>EUR</currency>
      <periodLength>1</periodLength>
      <periodUnit>MONTH</periodUnit>
      <startDateTime>2018-06-05 10:54:51 UTC</startDateTime>
    </startSchedule>
  </debit>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$debit = new \PaymentGateway\Client\Transaction\Debit();
$debit
 ->setTransactionId('transaction-00001')
 ->setAmount(4.99)
 ->setCurrency('EUR')
 ->setDescription('Transaction Description')
 ->setSuccessUrl('https://link.to/your/payment-successful-page')
 ->setCancelUrl('https://link.to/your/payment-canceled-page')
 ->setErrorUrl('https://link.to/your/payment-failed-page')
 ->setCallbackUrl('https://link.to/your/notification-handler');

$customer = new \PaymentGateway\Client\Data\Customer();
$customer
 ->setFirstName('John')
 ->setLastName('Smith')
 ->setIdentification('1111')
 ->setBillingCountry('AT')
 ->setEmail('[email protected]')
 ->setIpAddress('123.123.123.123');

$debit->setCustomer($customer);

$debit->setWithRegister(true);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setAmount(5.99);
$scheduleData->setCurrency('EUR');
$scheduleData->setPeriodLength(1);
$scheduleData->setPeriodUnit('MONTH');

$firstPeriodIsTrialPeriod = true;
$trialPeriodLength = '10 days';
$startDateTime = \new DateTime('+' . $trialPeriodLength);

if ($firstPeriodIsTrialPeriod) {
    $scheduleData->setStartDateTime($startDateTime);
}

$debit->setSchedule($scheduleData);

$result = $client->debit($debit);

Response
<?xml version="1.0" encoding="utf-8"?>
<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>true</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <registrationId>aab69791ddedcaeae4ae</registrationId>
  <returnType>FINISHED</returnType>
  <scheduleId>SC-7FF3-37B8-0F27-8BCA-5B3D-90DB</scheduleId>
  <scheduleStatus>ACTIVE</scheduleStatus>
  <scheduledAt>2018-07-05 16:22:06 UTC</scheduledAt>
</result>

<?xml version="1.0" encoding="utf-8"?>
<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>true</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <returnType>FINISHED</returnType>
</result>

<?php
$result = $client->debit($debit);

if ($result->getReturnType() == PaymentGateway\Client\Transaction\Result::RETURN_TYPE_FINISHED) {
    //transaction was successful
    $uuid = $result->getReferenceId();

    //proceed with your checkout process
}

<?xml version="1.0" encoding="utf-8"?>
<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>false</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <returnType>ERROR</returnType>
  <errors>
    <error>
      <message>Card number invalid</message>
      <code>2008</code>
      <adapterMessage>Invalid card number</adapterMessage>
      <adapterCode>200</adapterCode>
    </error>
  </errors>
</result>

<?php
$result = $client->debit($debit);

if ($result->getReturnType() == PaymentGateway\Client\Transaction\Result::RETURN_TYPE_ERROR) {
    //transaction failed
    $error = $result->getFirstError();
    $errorMessage = $error->getMessage();
    $errorCode = $error->getCode();

    //if reasonable tell your customer to choose a different payment method
}

<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>true</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <returnType>REDIRECT</returnType
  <redirectUrl>https://gateway.tillpayments.com/redirect/12345678901234567890/ABCDEF01234567890ABCDEF01234567890=</redirectUrl>
</result>

<?php
$result = $client->debit($debit);

if ($result->getReturnType() == PaymentGateway\Client\Transaction\Result::RETURN_TYPE_REDIRECT) {
    //transaction needs redirection
    $uuid = $result->getReferenceId();
    $redirectUrl = $result->getRedirectUrl();

    header('Location: '.$redirectUrl);
    exit;
}

<?xml version="1.0" encoding="utf-8"?>
<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>true</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <returnType>PENDING</returnType>
</result>

<?php
$result = $client->debit($debit);

if ($result->getReturnType() == PaymentGateway\Client\Transaction\Result::RETURN_TYPE_PENDING) {
    //transaction is pending
    $uuid = $result->getReferenceId();

    //wait for the postback notification for the final result
}

<?xml version="1.0" encoding="utf-8"?>
<result xmlns="http://gateway.tillpayments.com/Schema/V2/Result">
  <success>true</success>
  <referenceId>12345678901234567890</referenceId>
  <purchaseId>20170101-12345678901234567890</purchaseId>
  <registrationId>aab69791ddedcaeae4ae</registrationId>
  <returnType>FINISHED</returnType>
  <scheduleId>SC-7AA3-37B8-0F27-8BCA-5B3D-90DB</scheduleId>
  <scheduleStatus>ACTIVE</scheduleStatus>
  <scheduledAt>2018-07-05 16:22:06 UTC</scheduledAt>
</result>

<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://gateway.tillpayments.com/Schema/V2/Callback">
  <result>OK</result>
  <referenceId>edcba123456789012345</referenceId>
  <transactionId>YOUR_TRANSACTION_ID</transactionId>
  <purchaseId>20170120-edcba123456789012345</purchaseId>
  <transactionType>DEBIT</transactionType>
  <merchantMetaData>YOUR_OPTIONAL_META_DATA</merchantMetaData>
  <amount>4.99</amount>
  <currency>USD</currency>
  <returnData type="creditcardData">
    <creditcardData>
      <type>visa</type>
      <cardHolder>Max Mustermann</cardHolder>
      <expiryMonth>10</expiryMonth>
      <expiryYear>2020</expiryYear>
      <firstSixDigits>411111</firstSixDigits>
      <lastFourDigits>1111</lastFourDigits>
      <fingerprint>ABCXYZ...</fingerprint>
      <threeDSecure>MANDATORY</threeDSecure>
      <eci>05</eci>
      <binBrand>VISA</binBrand>
      <binBank>Issuing Bank</binBank>
      <binCountry>AT</binCountry>
    </creditcardData>
  </returnData>
  <customerData>
    <identification>1111</identification>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <billingCountry>AT</billingCountry>
    <email>[email protected]</email>
    <ipAddress>123.123.123.123</ipAddress>
  </customerData>
</callback>

<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://gateway.tillpayments.com/Schema/V2/Callback">
  <result>ERROR</result>
  <referenceId>edcba123456789012345</referenceId>
  <transactionId>YOUR_TRANSACTION_ID</transactionId>
  <purchaseId>20170120-edcba123456789012345</purchaseId>
  <transactionType>DEBIT</transactionType>
  <merchantMetaData>YOUR_OPTIONAL_META_DATA</merchantMetaData>
  <amount>4.99</amount>
  <currency>USD</currency>
  <errors>
    <error>
      <message>Card invalid</message>
      <code>2008</code>
      <adapterMessage>Invalid Card Entered</adapterMessage>
      <adapterCode>100.000.100</adapterCode>
    </error>
  </errors>
  <returnData type="creditcardData">
    <creditcardData>
      <type>visa</type>
      <country>AT</country>
      <cardHolder>Max Mustermann</cardHolder>
      <expiryMonth>10</expiryMonth>
      <expiryYear>2020</expiryYear>
      <firstSixDigits>411111</firstSixDigits>
      <lastFourDigits>1111</lastFourDigits>
    </creditcardData>
  </returnData>
  <customerData>
    <identification>1111</identification>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <billingCountry>AT</billingCountry>
    <email>[email protected]</email>
    <ipAddress>123.123.123.123</ipAddress>
  </customerData>
</callback>

<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://gateway.tillpayments.com/Schema/V2/Callback">
  <result>OK</result>
  <referenceId>edcba123456789012345</referenceId>
  <transactionId>YOUR_TRANSACTION_ID</transactionId>
  <purchaseId>20170120-edcba123456789012345</purchaseId>
  <transactionType>DEBIT</transactionType>
  <merchantMetaData>YOUR_OPTIONAL_META_DATA</merchantMetaData>
  <amount>4.99</amount>
  <currency>USD</currency>
  <errors>
    <error>
      <message>Card declined</message>
      <code>2003</code>
      <adapterMessage>Card declined by authorisation System</adapterMessage>
      <adapterCode>301.110</adapterCode>
    </error>
  </errors>
</callback>

<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://gateway.tillpayments.com/Schema/V2/Callback">
  <result>OK</result>
  <referenceId>edcba123456789012345</referenceId>
  <transactionId>auto-generated-id</transactionId>
  <purchaseId>20170120-edcba123456789012345</purchaseId>
  <transactionType>CHARGEBACK</transactionType>
  <amount>9.99</amount>
  <currency>EUR</currency>
  <chargebackData>
    <originalReferenceId>abcdef123456123456</originalReferenceId>
    <originalTransactionId>YOUR_TRANSACTION_ID</originalTransactionId>
    <amount>9.99</amount>
    <currency>EUR</currency>
    <reason>customer_chargeback</reason>
    <chargebackDateTime>2017-02-10T04:36:09Z</chargebackDateTime>
  </chargebackData>
</callback>

<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://gateway.tillpayments.com/Schema/V2/Callback">
  <result>OK</result>
  <referenceId>b5c36138ada44ca09d45</referenceId>
  <transactionId>auto-generated-id</transactionId>
  <purchaseId>20170120-edcba123456789012345</purchaseId>
  <transactionType>CHARGEBACK-REVERSAL</transactionType>
  <amount>9.99</amount>
  <currency>EUR</currency>
  <chargebackReversalData>
    <originalReferenceId>abcdef123456123456</originalReferenceId>
    <originalTransactionId>YOUR_TRANSACTION_ID</originalTransactionId>
    <chargebackReferenceId>edcba123456789012345</chargebackReferenceId>
    <amount>9.99</amount>
    <currency>EUR</currency>
    <reason>dispute_won</reason>
    <reversalDateTime>2017-03-26T11:27:15Z</reversalDateTime>
  </chargebackReversalData>
</callback>

Status Request with the UUID
<?xml version="1.0" encoding="utf-8"?>
<status xmlns="http://gateway.tillpayments.com/Schema/V2/Status">
  <username>YOUR_USERNAME</username>
  <password>SHA1 HASHED PASSWORD</password>
  <transactionUuid>aa85fdb3c5f2048bd77f</transactionUuid>
</status>


Status Request with the merchantTransactionId
<?xml version="1.0" encoding="utf-8"?>
<status xmlns="http://gateway.tillpayments.com/Schema/V2/Status">
  <username>YOUR_USERNAME</username>
  <password>SHA1 HASHED PASSWORD</password>
  <merchantTransactionId>20181127103341</merchantTransactionId>
</status>


Status Result
<?xml version="1.0" encoding="utf-8"?>
<statusResult xmlns="http://gateway.tillpayments.com/Schema/V2/StatusResult">
  <operationSuccess>true</operationSuccess>
  <transactionStatus>SUCCESS</transactionStatus>
  <transactionUuid>aa85fdb3c5f2048bd77f</transactionUuid>
  <merchantTransactionId>20181127103341</merchantTransactionId>
  <purchaseId>20181127-aa85fdb3c5f2048bd77f</purchaseId>
  <transactionType>DEBIT</transactionType>
  <paymentMethod>Bitcoin</paymentMethod>
  <amount>9.99</amount>
  <currency>EUR</currency>
  <customerData>
    <firstName>Max</firstName>
    <lastName>Mustermann</lastName>
    <company>Test Company</company>
    <email>[email protected]</email>
    <emailVerified>false</emailVerified>
    <ipAddress>127.0.0.1</ipAddress>
  </customerData>
</statusResult>


Status Result with Error
<?xml version="1.0" encoding="utf-8"?>
<statusResult xmlns="http://gateway.tillpayments.com/Schema/V2/StatusResult">
  <operationSuccess>false</operationSuccess>
  <errors>
    <error>
      <message>Transaction not found</message>
      <code>8001</code>
    </error>
  </errors>
</statusResult>

<?php
$username = 'Your Username';
$password = 'Your password';
$apiKey = 'Connector API Key';
$sharedSecret = 'Connector Shared Secret';


$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);
$statusRequestData = new \PaymentGateway\Client\StatusApi\StatusRequestData();

// use either the UUID or your merchantTransactionId but not both
//$statusRequestData->setTransactionUuid($transactionUuid);
$statusRequestData->setMerchantTransactionId($merchantTransactionId);

$statusResult = $client->sendStatusRequest($statusRequestData);

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <startSchedule>
    <registrationId>theReferenceTransactionIdFromYourRegister</registrationId>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <periodLength>1</periodLength>
    <periodUnit>MONTH</periodUnit>
    <startDateTime>2018-06-05 14:26:11 UTC</startDateTime>
  </startSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setAmount(5.99);
$scheduleData->setCurrency('EUR');
$scheduleData->setPeriodLength(1);
$scheduleData->setPeriodUnit('MONTH');
$startDateTime = new \DateTime('+ 1 month');
$scheduleData->setStartDateTime($startDateTime);

$scheduleResult = $client->startSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess() && $scheduleResult->getNewStatus() == ScheduleResult::STATUS_ACTIVE) {
    //operation was successful
    $scheduleId = $scheduleResult->getScheduleId();
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>SC-B747-8636-D03F-1DB2-18F8-A4F1</scheduleId>
  <oldStatus>NON-EXISTING</oldStatus>
  <newStatus>ACTIVE</newStatus>
  <scheduledAt>2019-07-05 16:11:21 UTC</scheduledAt>
</scheduleResult>

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <updateSchedule>
    <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
    <registrationId>theReferenceTransactionIdFromYourRegister</registrationId>
    <amount>4.99</amount>
    <currency>EUR</currency>
    <periodLength>1</periodLength>
    <periodUnit>MONTH</periodUnit>
    <startDateTime>2018-06-05 14:26:11 UTC</startDateTime>
  </updateSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setScheduleId($scheduleId); // the scheduleId you have received in the Result of the startSchedule - Call
$scheduleData->setAmount(5.99);
$scheduleData->setCurrency('EUR');
$scheduleData->setPeriodLength(1);
$scheduleData->setPeriodUnit('MONTH');
$startDateTime = new \DateTime('+ 1 month');
$scheduleData->setStartDateTime($startDateTime);

$scheduleResult = $client->startSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess() && $scheduleResult->getNewStatus() == ScheduleResult::STATUS_ACTIVE) {
    //operation was successful
    $scheduleId = $scheduleResult->getScheduleId();
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>SC-B747-8636-D03F-1DB2-18F8-A4F1</scheduleId>
  <oldStatus>ACTIVE</oldStatus>
  <newStatus>ACTIVE</newStatus>
  <scheduledAt>2019-07-05 16:11:21 UTC</scheduledAt>
</scheduleResult>

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <showSchedule>
    <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  </showSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setScheduleId($scheduleId); // the scheduleId you have received in the Result of the startSchedule - Call

$scheduleResult = $client->showSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess()) {
    $currentStatus = $scheduleResult->getNewStatus();
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  <oldStatus>ACTIVE</oldStatus>
  <newStatus>ACTIVE</newStatus>
  <scheduledAt>2019-07-05 16:11:21 UTC</scheduledAt>
</scheduleResult>

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <pauseSchedule>
    <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  </pauseSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setScheduleId($scheduleId); // the scheduleId you have received in the Result of the startSchedule - Call

$scheduleResult = $client->pauseSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess() && $scheduleResult->getNewStatus() == ScheduleResult::STATUS_PAUSED) {
    //operation was successful
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  <oldStatus>ACTIVE</oldStatus>
  <newStatus>PAUSED</newStatus>
</scheduleResult>

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <continueSchedule>
    <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
    <continueDateTime>2019-06-05 14:26:11 UTC</continueDateTime>
  </continueSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setScheduleId($scheduleId); // the scheduleId you have received in the Result of the startSchedule - Call
$continueDateTime = new \DateTime('+ 10 days');
$scheduleData->setContinueDateTime($continueDateTime);

$scheduleResult = $client->continueSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess() && $scheduleResult->getNewStatus() == ScheduleResult::STATUS_ACTIVE) {
    //operation was successful
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  <oldStatus>PAUSED</oldStatus>
  <newStatus>ACTIVE</newStatus>
  <scheduledAt>2019-07-05 16:11:21 UTC</scheduledAt>
</scheduleResult>

Request
<?xml version="1.0" encoding="utf-8"?>
<schedule xmlns="http://gateway.tillpayments.com/Schema/V2/Schedule">
  <username>API_USER</username>
  <password>5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8</password>
  <cancelSchedule>
    <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  </cancelSchedule>
</schedule>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$scheduleData = new  \PaymentGateway\Client\Schedule\ScheduleData();

$scheduleData->setScheduleId($scheduleId); // the scheduleId you have received in the Result of the startSchedule - Call

$scheduleResult = $client->cancelSchedule($scheduleData);

if ($scheduleResult->getOperationSuccess() && $scheduleResult->getNewStatus() == ScheduleResult::STATUS_CANCELLED) {
    //operation was successful
} else {
    $errors = $scheduleResult->getErrors();
}

Response
<?xml version="1.0" encoding="utf-8"?>
<scheduleResult xmlns="http://gateway.tillpayments.com/Schema/V2/ScheduleResult">
  <operationSuccess>true</operationSuccess>
  <scheduleId>theScheduleIdYouHaveReceivedInTheStartScheduleResult</scheduleId>
  <oldStatus>ACTIVE</oldStatus>
  <newStatus>CANCELLED</newStatus>
</scheduleResult>

<?xml version="1.0" encoding="utf-8"?>
<options xmlns="http://gateway.tillpayments.com/Schema/V2/Options">
  <username>API_USERNAME</username>
  <password>API_PASSWORD (SHA1 HASHED)</password>
  <request>
    <identifier>epsBankList</identifier>
  </request>
</options>

<?php
$username = 'Your Username';
$password = 'Your password';
$apiKey = 'Connector API Key';
$sharedSecret = 'Connector Shared Secret';

$client = new \PaymentGateway\Client\Client($username, $password, $apiKey, $sharedSecret);

$bankList = $client->getOptions('epsBankList');

<?xml version="1.0" encoding="utf-8"?>
<options xmlns="http://gateway.tillpayments.com/Schema/V2/Options">
  <response>
    <success>true</success>
    <parameter name="HAABAT2KXXX">Austrian Anadi Bank AG</parameter>
    <parameter name="VRBKAT21XXX">VR-Bank Braunau</parameter>
    <parameter name="VKBLAT2LXXX">Volkskreditbank AG</parameter>
    <parameter name="SPADATW1XXX">Sparda Bank Wien</parameter>
    ...
  </response>
</options>

<?php
$bankList = $client->getOptions('epsBankList');
print_r($bankList);
/*
    Array
    (
        [HAABAT2KXXX] => Austrian Anadi Bank AG
        [VRBKAT21XXX] => VR-Bank Braunau
        [VKBLAT2LXXX] => Volkskreditbank AG
        [SPADATW1XXX] => Sparda Bank Wien
        ...
    )
*/

<?php
$password = 'myPassword';
$password = sha1($password);

var pass = "myPassword";
var sha1 = SHA1.Create();
var hash = sha1.ComputeHash(System.Text.Encoding.ASCII.GetBytes(pass));
pass = this.ByteToString(hash).ToLower(); //see function below

protected string ByteToString(byte[] buff)
{
  StringBuilder sb = new StringBuilder();
  for (int i = 0; i < buff.Length; i++)
  {
    sb.Append(buff[i].ToString("X2"));
  }
  return sb.ToString();
}

import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

String password = 'myPassword';

MessageDigest md;
try {
  md = MessageDigest.getInstance("SHA-1");
} catch( NoSuchAlgorithmException e ) {
  // should never happen since MessageDigest doc says SHA-1 must be on every JVM
  throw new RuntimeException("couldn't get SHA-1 digest", e);
}
byte[] digest = password.getBytes(StandardCharsets.UTF_8);
md.reset();
digest = Hex.hex(md.digest(digest)).getBytes(StandardCharsets.UTF_8);

password = new String(digest, StandardCharsets.UTF_8);

<?php 
$method = 'POST';
$xml = '...'; //see Transaction Request chapter
$contentType = 'text/xml; charset=utf-8';
$date = new \DateTime('now', new \DateTimeZone('UTC'));
$timestamp = $date->format('D, d M Y H:i:s T');
$additionals = '';
$requestUri = '/transaction';

$signatureMessage = join("\n", [$method, hash("sha512", $xml), $contentType, $timestamp, $additionals, $requestUri]);

$digest = hash_hmac('sha512', $signatureMessage, 'THE_SHARED_SECRET', true);
$signature = base64_encode($digest);

var sharedSecret = "SHARED_SECRET";
var method = "POST";
var bodySHA512 = MakeSHA512Hash(transactionXml);
var contentType = "text/xml; charset=utf-8";
var date = new DateTime();
var timestamp = date.ToUniversalTime().ToString("r");
var additionals = "";
var requestUri = "/transaction";

var signatureMessage = method + "\n" + bodySHA512 + "\n" + contentType + "\n" + timestamp + "\n" + additionals + "\n" + requestUri;

var hmacSha512 = new HMACSHA512(Encoding.UTF8.GetBytes(sharedSecret));
var hash = hmacSha512.ComputeHash(Encoding.UTF8.GetBytes(signatureMessage));

var signature = System.Convert.ToBase64String(hash); //this is what we need now


public string MakeSHA512Hash(string content) {
  SHA512 sha512 = new SHA512Managed();
  byte[] inputBytes = System.Text.Encoding.UTF8.GetBytes(input);
  byte[] hash = sha512.ComputeHash(inputBytes);

  StringBuilder sb = new StringBuilder();
  for (int i = 0; i < hash.Length; i++) {
    sb.Append(hash[i].ToString("X2"));
  }
  return sb.ToString();
}

// No Java example yet

curl \
-d "PUT_XML_HERE" \
-H "Authorization: Gateway THE_API_KEY:Signature" \
-H "Content-Type: text/xml" \
"https://gateway.tillpayments.com/transaction"

<?php 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Gateway THE_API_KEY:'.$signature,
    'Date: '.$timestamp, //from above
    'Content-Type: '.$contentType
);

var apiKey = 'YOUR_API_KEY';
var request = (HttpWebRequest)WebRequest.Create("https://gateway.tillpayments.com/transaction");

//values from above
request.Method = method;
request.ContentType = contentType;
request.ContentLength = transactionXml.Length;

request.Date = now;
request.Headers.Add("Authorization: Gateway " + apiKey + ":" + signature);

// No Java example yet

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>YOUR_USERNAME</username>
  <password>SHA1 HASHED PASSWORD</password>
  <debit>
    <transactionId>Your Transaction ID</transactionId>
    <customer>
      <identification>Customer ID</identification>
      <firstName>Prename</firstName>
      <lastName>Surname</lastName>
      <company>Company Name</company>
      <email>Valid Email Address</email>
      <ipAddress>IP4 Address</ipAddress> <!-- Kount requires a valid IP4 address -->
    </customer>
    <extraData key="KOUNT_SITE">Your Kount Site configured in Kount</extraData> <!-- required -->
    <extraData key="KOUNT_SESSION_ID">unique kountSessionId</extraData> <!-- required when PaymentJS is not used -->
    <extraData key="KOUNT_UDF[YOUR_USER_DEFINED_FIELD_1]">test</extraData> <!-- optional -->
    <extraData key="KOUNT_UDF[YOUR_USER_DEFINED_FIELD_2]">test</extraData> <!-- optional -->

    <extraData key="KOUNT_TOTAL_AMOUNT">4.80</extraData> <!-- optional - if amount to evaluate differs from transaction amount -->
    <extraData key="KOUNT_CURRENCY">EUR</extraData> <!-- optional - if currency to evaluate differs from transaction currency -->

    <!--  at least one item beginning with index = 0 is required or otherwise use alternative way described below -->
    <extraData key="KOUNT_PROD_TYPE[0]">Item Type</extraData> <!-- e.g. item category -->
    <extraData key="KOUNT_PROD_ITEM[0]">Item Name</extraData>
    <extraData key="KOUNT_PROD_DESC[0]">Item Description</extraData>
    <extraData key="KOUNT_PROD_QUANT[0]">1</extraData> <!-- quantity -->
    <extraData key="KOUNT_PROD_PRICE[0]">4.80</extraData> <!-- price in same currency like transaction currency -->

    <amount>4.80</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>

    <!-- alternative way for item data (not available for type register):
    <items>
      <item>
        <extraData key="KOUNT_PROD_TYPE">The Item Type</extraData>
        <extraData key="KOUNT_PROD_ITEM">Item Name</extraData>
        <extraData key="KOUNT_PROD_DESC">Item Description</extraData>
        <extraData key="KOUNT_PROD_QUANT">1</extraData>
        <extraData key="KOUNT_PROD_PRICE">4.80</extraData>
      </item>
    </items> -->

    <withRegister>false</withRegister>
  </debit>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey);

$debit = new Debit();
$debit->setTransactionId($merchantTransactionId)
    ->setAmount(4.80)
    ->setCurrency('EUR')
    ->setDescription('One pair of shoes')
    ->setCustomer($customer)
    ->addExtraData('KOUNT_SITE', 'your_value_for_site') // required
    //->addExtraData('KOUNT_SESSION_ID', 'unique kountSessionId') // required when PaymentJS is not used
    //->addExtraData('KOUNT_UDF[YOUR_USER_DEFINED_FIELD_1]', 'test') // optional
    //->addExtraData('KOUNT_UDF[YOUR_USER_DEFINED_FIELD_2]', 'test') // optional

    //->addExtraData('KOUNT_TOTAL_AMOUNT', 4.80) // optional - if amount to evaluate differs from transaction amount
    //->addExtraData('KOUNT_CURRENCY', 'EUR') // optional - if currency to evaluate differs from transaction currency

    //->addExtraData('KOUNT_UDF[YOUR_USER_DEFINED_FIELD_2]', 'test') // optional
    ->setCallbackUrl('https://myhost.com/path/to/my/callbackHandler')
    ->setSuccessUrl('https://myhost.com/checkout/successPage')
    ->setErrorUrl('https://myhost.com/checkout/errorPage')

    // at least one item beginning with index = 0 is required or otherwise use alternative way described below
    ->addExtraData('KOUNT_PROD_TYPE[0]', 'Item Type') // e.g. item category
    ->addExtraData('KOUNT_PROD_ITEM[0]', 'Item Name')
    ->addExtraData('KOUNT_PROD_DESC[0]', 'Item Description')
    ->addExtraData('KOUNT_PROD_QUANT[0]', '1') // quantity
    ->addExtraData('KOUNT_PROD_PRICE[0]', '4.80') // price in same currency like transaction currency

/* alternative way for item data (not possible with type register):
$item = new \PaymentGateway\Client\Data\Item();
$item->addExtraData('KOUNT_PROD_TYPE', 'Item Type')
    ->addExtraData('KOUNT_PROD_ITEM', 'Item Name')
    ->addExtraData('KOUNT_PROD_DESC', 'Item Description')
    ->addExtraData('KOUNT_PROD_QUANT', '1')
    ->addExtraData('KOUNT_PROD_PRICE', '4.80');
$debiit->addItem($item); */

$result = $client->debit($debit);

<?xml version="1.0" encoding="utf-8"?>
<transaction xmlns="http://gateway.tillpayments.com/Schema/V2/Transaction">
  <username>YOUR_USERNAME</username>
  <password>SHA1 HASHED PASSWORD</password>
  <debit>
    <transactionId>Your Transaction ID</transactionId>
    <customer>
      <identification>Customer ID</identification>
      <firstName>John</firstName>
      <lastName>Smith</lastName>
      <email>[email protected]</email>
      <gender>MALE</gender>
      <birthDate></birthDate>
      <ipAddress>IP4 Address</ipAddress> <!-- Forter requires a valid IP4 address -->
      <billingAddress1>235 Montgomery st.</billingAddress1> <!-- required -->
      <billingCity>San Francisco</billingCity><!-- required -->
      <billingCountry>US</billingCountry><!-- required -->
      <billingAddress2>street 2</billingAddress2> <!-- conditional Unit-level address -->
      <billingPostcode>94104</billingPostcode><!-- conditional Zipcode -->
      <billingState>CA</billingState><!-- conditional Top-level administrative subdivision - state/province/department/etc. Can be either abbreviated format or full name (NY/New York) -->
      <billingPhone>15557654321</billingPhone><!-- conditional Phone number including all country and local access codes -->

      <shippingAddress1>235 Montgomery st.</shippingAddress1> <!-- required -->
      <shippingCity>San Francisco</shippingCity><!-- required -->
      <shippingCountry>US</shippingCountry><!-- required -->
      <shippingAddress2>street 2</shippingAddress2> <!-- conditional Unit-level address -->
      <shippingPostcode>94104</shippingPostcode><!-- conditional Zipcode -->
      <shippingState>CA</shippingState><!-- conditional Top-level administrative subdivision - state/province/department/etc. Can be either abbreviated format or full name (NY/New York) -->
      <shippingPhone>15557654321</shippingPhone><!-- conditional Phone number including all country and local access codes -->

      <extraData key="FORTER_CUSTOMER_PAST_ORDERS_COUNT">0</extraData> <!-- optional Integer -->
      <extraData key="FORTER_CUSTOMER_PAST_ORDERS_SUM_USD">0.00</extraData> <!-- optional decmimal -->
      <extraData key="FORTER_CUSTOMER_LAST_LOGINIP">203.12.55.12</extraData> <!-- optional Possible values are: "HOME", "BUSINESS", "OTHER" -->
      <extraData key="FORTER_CUSTOMER_REGISTRATION_IP">203.12.55.12</extraData> <!-- optional Possible values are: "HOME", "BUSINESS", "OTHER" -->

      <extraData key="FORTER_CUSTOMER_BILLING_ADDRESS_TYPE">HOME</extraData> <!-- conditional Possible values are: "HOME", "BUSINESS", "OTHER" -->
      <extraData key="FORTER_CUSTOMER_BILLING_CREATION_TIME">1448549922</extraData> <!-- conditional Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970) -->
      <extraData key="FORTER_CUSTOMER_BILLING_REMOVAL_TIME">1448895522</extraData> <!-- conditional Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970) -->
      <extraData key="FORTER_CUSTOMER_BILLING_SUGGESTED_CORRECT_ADDRESS">true</extraData> <!-- conditional True if customer selected a corrected address suggested by merchant (For example in cases where customer entered wrong zipcode) -->

      <!-- Verification Documents -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_TYPE">Passport</extraData> <!-- required ype of document (Passport, ID, Driving license) Maximum length is 35 characters. -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_SOURCE">UPLOADED_FILE</extraData> <!-- required Source of document (e.g. uploaded file, captured by camera, typed in by customer, etc.) Possible values are: "CAMERA_CAPTURED", "UPLOADED_FILE", "TYPED", "OTHER" -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_NATIONALITY">US</extraData> <!-- conditional Document holder's nationality -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_ISSUING_STATE">NY</extraData> <!-- conditional Document issuing state or region -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_NUMBER">20439190</extraData> <!-- conditional Official document's number (e.g. passport number, driving license number, etc.) -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_FIRSTNAME">John</extraData> <!-- conditional First name as appears on the document -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_LASTNAME">Smith</extraData> <!-- conditional Last name as appears on the document -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_DATEOFBIRTH">true</extraData> <!-- conditional Date of birth as appears on the document. Use YYYY-MM-DD format. -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_EXPIRATION">true</extraData> <!-- conditional Document's exipration date. Use YYYY-MM-DD format. -->
      <extraData key="FORTER_CUSTOMER_BILLING_VERIFICATION_DOCUMENT_PAYLOAD">{}}</extraData> <!-- conditional JSON Response payload received from 3rd party document verification -->

      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_TYPE">Passport</extraData> <!-- required ype of document (Passport, ID, Driving license) Maximum length is 35 characters. -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_SOURCE">UPLOADED_FILE</extraData> <!-- required Source of document (e.g. uploaded file, captured by camera, typed in by customer, etc.) Possible values are: "CAMERA_CAPTURED", "UPLOADED_FILE", "TYPED", "OTHER" -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_NATIONALITY">US</extraData> <!-- conditional Document holder's nationality -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_ISSUING_STATE">NY</extraData> <!-- conditional Document issuing state or region -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_NUMBER">20439190</extraData> <!-- conditional Official document's number (e.g. passport number, driving license number, etc.) -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_FIRSTNAME">John</extraData> <!-- conditional First name as appears on the document -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_LASTNAME">Smith</extraData> <!-- conditional Last name as appears on the document -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_DATEOFBIRTH">true</extraData> <!-- conditional Date of birth as appears on the document. Use YYYY-MM-DD format. -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_EXPIRATION">true</extraData> <!-- conditional Document's exipration date. Use YYYY-MM-DD format. -->
      <extraData key="FORTER_CUSTOMER_SHIPPING_VERIFICATION_DOCUMENT_PAYLOAD">{}}</extraData> <!-- conditional JSON Response payload received from 3rd party document verification -->

    </customer>

    <!-- Order & ConnectionInformation --> 
    <extraData key="FORTER_TYPE">WEB</extraData> <!-- optional, default WEB. Platform order was made through. Possible Values: "WEB", "PHONE", "MOBILE", "IOS", "ANDROID", "WAP", "STORE", "MAIL_ORDER", "AUTOMATIC_RENEWAL_OR_INSTALLMENT_PAYMENT", "UNKNOWN" -->
    <extraData key="FORTER_TOKEN">2315688945984</extraData> <!-- conditional Forter token cookie from request headers. Maximum length is 128 characters. -->
    <extraData key="FORTER_USER_AGENT">Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.90 Safari/537.36</extraData> <!-- required when PaymentJS is not used, Customer's User agent. Maximum length is 4096 characters. -->
    <extraData key="FORTER_CHECKOUT_TIME">1415273168</extraData> <!-- optional will use current timestamp if not provided. The time when the buyer completed the checkout process in the merchant website in SECONDS since unix epoch (Jan 1, 1970). -->
    <extraData key="FORTER_MOBILE_UID">6429751237891</extraData> <!-- optional - mobile UID. The device identifier such as IMEI in android or identifier for vendor in iOS. This should match the deviceId sent via the mobile events API (for mobile transactions only) Maximum length is 128 characters. -->
    <extraData key="FORTER_MERCHANT_DEVICE_IDENTIFIER">HGJ7512345H3</extraData> <!-- conditional - A unique device identifier generated by merchant -->
    <extraData key="FORTER_MOBILE_APP_VERSION">2.9</extraData> <!-- conditional - The version of the merchant application which is running on the user's device -->
    <extraData key="FORTER_MOBILE_OS_TYPE">Android</extraData> <!-- conditional - The operating system running on the user's device (relevant for native app only) -->
    <extraData key="FORTER_MOBILE_DEVICE_BRAND">Samsung</extraData> <!-- conditional - The user's device brand (relevant for native app only) -->
    <extraData key="FORTER_MOBILE_DEVICE_MODEL">Galaxy 3</extraData> <!-- conditional - The model of the user's device (relevant for native app only) -->
    <extraData key="FORTER_FULL_HEADERS_JSON">"{"method":"GET / HTTP/1.1", "Host": "forter.com", "Connection": "keep-alive", "Accept": ...}"</extraData> <!-- conditional - A unique device identifier generated by merchant -->

    <!-- Delivery --> 
    <extraData key="FORTER_DELIVERY_DETAILS_DELIVERY_TYPE">DIGITAL</extraData> <!-- optional default DIGITAL - Type of delivery: PHYSICAL for any type of shipped goods. DIGITAL for non-shipped goods (services, gift cards etc.) Example: PHYSICAL Possible values are: "DIGITAL", "PHYSICAL", "HYBRID" -->
    <extraData key="FORTER_DELIVERY_DETAILS_DELIVERY_METHOD">Galaxy</extraData> <!-- optional default EMAIL - Delivery method chosen by customer such as postal service, email, in game transfer, etc. Example: USPS - Ground Mail  -->
    <extraData key="FORTER_DELIVERY_DETAILS_DELAYED_DELIVERY_DATE">2018-10-12</extraData> <!-- conditional - Use if customer chose to deliver the item at a later date (to arrive in time for a holiday, a birthday, etc.). Use YYYY-MM-DD format. -->
    <extraData key="FORTER_DELIVERY_DETAILS_CARRIER">DHL</extraData> <!-- optional - -->
    <extraData key="FORTER_DELIVERY_DETAILS_DELIVERY_PRICE_AMOUNT">5.00</extraData> <!-- conditional - same currency as transaction currency is assumed -->
    <extraData key="FORTER_DELIVERY_DETAILS_TRACKING_EXTRA_CHARGE_AMOUNT">1.00</extraData> <!-- conditional - same currency as transaction currency is assumed -->
    <extraData key="FORTER_DELIVERY_DETAILS_EXPECTED_DELIVERY_DATE">2018-10-14</extraData> <!-- conditional - Date delivery is expected to arrive at destination. Use YYYY-MM-DD -->
    <extraData key="FORTER_DELIVERY_DETAILS_LEAVE_OUTSIDE">1</extraData> <!-- optional - 1 if customer chose to allow shipment to be left outside or at a building lobby or reception area. 1|0-->
    <extraData key="FORTER_DELIVERY_DETAILS_SMS_UPDATES">0</extraData> <!-- optional - 1 if customer asked to receive SMS updates regarding delivery. 1|0-->
    <extraData key="FORTER_DELIVERY_DETAILS_WAIT_TO_SHIP_TOGETHER">0</extraData> <!-- conditional - 1 if customer asked to try and bundle shipments together to save costs. 1|0-->
    <extraData key="FORTER_DELIVERY_DETAILS_DELIVERY_COMMENTS">Please call before arriving, Thanks!</extraData> <!-- conditional - Any comments or requests customer had for delivery -->

    <!-- Payment --> 
    <extraData key="FORTER_IS_MERCHANT_OF_RECORD">1</extraData> <!-- conditional - 1 if the Forter account owner is also the merchant of record-->
    <extraData key="FORTER_PAYMENT_METHOD_NICKNAME">My Work Card</extraData> <!-- conditional - Nickname assigned to this payment method by the user -->
    <extraData key="FORTER_PAYMENT_CREDIT_USED_AMOUNT">1.00</extraData> <!-- conditional - Store credit used to pay for purchase -->
    <extraData key="FORTER_IS_DEFAULT_PAYMENT_METHOD">1</extraData> <!-- conditional - 1 if this payment instrument is the default set by the customer. 0|1 -->
    <extraData key="FORTER_NUMBER_OF_INSTALLMENTS">12</extraData> <!-- conditional - Number of payments if customer chose to pay in several installments. integer -->
    <extraData key="FORTER_DELAYED_CHARGE">0</extraData> <!-- conditional - 1 if customer chose to pay at a later date. False if customer chose to pay in several installments as long as first payment is immediate. 1|0 -->
    <extraData key="FORTER_DELAYED_CHARGE_DATE">2015-12-01</extraData> <!-- conditional - Date customer is due to pay. Use YYYY-MM-DD format. -->

    <!-- Additional Identifiers -->
    <extraData key="FORTER_PAYMENT_GATEWAY_ID">SDS34653246346</extraData> <!-- conditional - Transaction identifier provided by the payment gateway -->
    <extraData key="FORTER_MERCHANT_ID">eh629dK9</extraData> <!-- conditional - Merchant unique identifier -->
    <extraData key="FORTER_MERCHANT_DOMAIN">HandbagsExpressDiscounts.com</extraData> <!-- conditional - Use if merchant operates several sites (such as a regular site and a related discount brand) -->
    <extraData key="FORTER_MERCHANT_NAME">Handbags Express Discounts</extraData> <!-- conditional - Use if merchant operates several sites (such as a regular site and a related discount brand) -->
    <extraData key="FORTER_SITE_LOCALIZATION_COUNTRY">FR</extraData> <!-- conditional - Use if site has multiple localized versions -->
    <extraData key="FORTER_SITE_LOCALIZATION_LANGUAGE">EN</extraData> <!-- conditional - Site interface language chosen by customer, 2-letter ISO-639-1 language code -->
    <extraData key="FORTER_SITE_LOCALIZATION_CURRENCY">USD</extraData> <!-- conditional - Currency chosen by customer as default, 3-letter ISO-4217 format currency code -->

    <!-- Items: if no items are provided directly, one will be submitted by default with the required data -->
    <extraData key="FORTER_ITEM_DEFAULT_QUANTITY">1</extraData> <!-- optional defaults to 1-->
    <extraData key="FORTER_ITEM_DEFAULT_TYPE">NON_TANGIBLE</extraData> <!-- optional default to NON_TANGIBLE - Tangible if physical item, non-tangible if any other product Example: TANGIBLE Possible values are: "TANGIBLE", "NON_TANGIBLE" -->
    <extraData key="FORTER_ITEM_DEFAULT_CREATED_TIME">1415273168</extraData> <!-- conditional - Time item was added to cart by customer in seconds since unix epoch (UTC, Jan 1, 1970) -->
    <extraData key="FORTER_ITEM_DEFAULT_SPECIFIC_DATA_JSON">{"personalCustomization":false, ....}</extraData> <!-- conditional - JSON with the format described here: https://portal.forter.com/app/developer/api/api/data-objects/ItemSpecificData -->

    <!-- Items: if provided as items (not available for type register) -->

    <items>
      <item>
        <identification>342S5453Gy</identification><!-- optional - Unique item ID. Use only if two identical items have different IDs. For example, two identical pairs of shoes should have different unique item IDs. -->
        <name>White GenericBrand handba</name><!-- optional - if not set transaction.description will be used -->
        <quantity>1</quantity><!-- optional default 1 -->
        <price>1.00</price><!-- required Final amount due for item, after all discounts and promotions -->
        <extraData key="FORTER_ITEM_TYPE">NON_TANGIBLE</extraData><!-- optional default to NON_TANGIBLE - Tangible if physical item, non-tangible if any other product Example: TANGIBLE Possible values are: "TANGIBLE", "NON_TANGIBLE" -->
        <extraData key="FORTER_ITEM_PRODUCTID">Unique identifier for item that is common to all identical items (such as SKU, ISBN, etc.)</extraData>
        <extraData key="FORTER_ITEM_PRODUCTID_TYPE">SKU</extraData><!-- optional - Type of product ID used (SKU/ISBN/UPC/etc.) -->
        <extraData key="FORTER_ITEM_CATEGORY">Item Category</extraData><!-- optional -->
        <extraData key="FORTER_ITEM_COUPON_CODE_USED">FATHERSDAY2015</extraData><!-- optional - The coupon code used -->
        <extraData key="FORTER_ITEM_DISCOUNT_TYPE">COUPON</extraData><!-- optional - Discount type -->
        <extraData key="FORTER_ITEM_SPECIFIC_DATA_JSON">{"personalCustomization":false, ....}</extraData><!-- conditional - JSON with the format described here: https://portal.forter.com/app/developer/api/api/data-objects/ItemSpecificData -->
        <extraData key="FORTER_ITEM_CREATED_TIME">{"personalCustomization":false, ....}</extraData><!-- conditional - JSON with the format described here: https://portal.forter.com/app/developer/api/api/data-objects/ItemSpecificData -->
      </item>
    </items>

    <amount>4.80</amount>
    <currency>EUR</currency>
    <description>Transaction Description</description>
    <successUrl>https://link.to/your/payment-successful-page</successUrl>
    <cancelUrl>https://link.to/your/payment-canceled-page</cancelUrl>
    <errorUrl>https://link.to/your/payment-failed-page</errorUrl>
    <callbackUrl>https://link.to/your/notification-handler</callbackUrl>

    <withRegister>false</withRegister>
  </debit>
</transaction>

<?php
$client = new \PaymentGateway\Client\Client($username, $password, $apiKey);

$customer = new Customer();
$customer->setFirstName('John')
    ->setLastName('Smith')
    ->setEmail('[email protected]')
    ->setBillingAddress1('235 Montgomery st.')
    ->setBillingPostcode('94104')
    ->setBillingCity('San Francisco')
    ->setBillingState('CA')
    ->setBillingCountry('US')
    ->addExtraData('FORTER_CUSTOMER_BILLING_CREATION_TIME', 1448549922);

$debit = new Debit();
$debit->setTransactionId($merchantTransactionId)
    ->setAmount(4.80)
    ->setCurrency('EUR')
    ->setDescription('One pair of shoes')
    ->setCustomer($customer)
    ->addExtraData('FORTER_TOKEN', 'forterCookieToken') // required when PaymentJS is not used
    ->addExtraData('FORTER_USER_AGENT', 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.90 Safari/537.36') // required when PaymentJS is not used (this will be retrieved from 3ds data per default)

    ->setCallbackUrl('https://myhost.com/path/to/my/callbackHandler')
    ->setSuccessUrl('https://myhost.com/checkout/successPage')
    ->setErrorUrl('https://myhost.com/checkout/errorPage')

/* alternative way for item data (not possible with type register):
$item = new \PaymentGateway\Client\Data\Item();
$item->setName('Item Name')
     ->setPrice(4.80)
     ->setQuantity(1)
     ->setDescription('Item Description)
     ->addExtraData('FORTER_ITEM_TYPE', 'TANGIBLE')
     ->addExtraData('FORTER_ITEM_CATEGORY', 'FOOD')
$debit->addItem($item);

$result = $client->debit($debit);