Use Direct Debit

Place an order using catalog products, and collect the payment using Wire transfers.

Request parameters

Parameter
Type / Description

sessionID

Required (string) Session identifier, the output of the Login method. Include sessionID into all your requests. 2Checkout throws an exception if the values are incorrect. The sessionID expires in 10 minutes.

Required (object) Object designed to collect all data necessary for an order, including billing, product / subscription plan and payment details.

Request sample

<?php

declare(strict_types=1);

class Configuration
{
    public const MERCHANT_CODE = 'MERCHANT_CODE';
    public const MERCHANT_KEY = 'SECRET_KEY';
    public const URL = 'http://api.2checkout/soap/6.0';
    public const ACTION = 'placeOrder';
    //array or JSON
    public const PAYLOAD = <<<JSON
{
    "Currency": "EUR",
    "Language": "EN",
    "Country": "NL",
    "CustomerIP": "91.220.121.21",
    "Source": "sourceAPI.net",
    "LocalTime": "2020-07-01 13:18:18",
    "Items": [
        {
            "Code": "A01",
            "Quantity": 1
        }
    ],
    "BillingDetails": {
        "Address1": "Test Address",
        "Address2": "Test Address2",
        "City": "Berlin",
        "State": "Berlin",
        "CountryCode": "NL",
        "Phone": 1234567,
        "Email": "[email protected]",
        "FirstName": "Customer",
        "LastName": "Customer",
        "Company": "Test Company",
        "Zip": "12345"
    },
    "DeliveryDetails": {
        "Address1": "Test Address",
        "Address2": "Test Address2",
        "City": "Berlin",
        "State": "Berlin",
        "CountryCode": "NL",
        "Phone": "12345",
        "Email": "[email protected]",
        "FirstName": "Customer",
        "LastName": "Customer",
        "Zip": 12345
    },
    "PaymentDetails": {
        "Type": "DIRECTDEBIT",
        "Currency": "EUR",
        "CustomerIP": "91.220.121.21",
        "PaymentMethod": {
            "FirstName": "John",
            "LastName": "Doe",
            "RecurringEnabled": true,
            "Iban": "NL12345678910"
        }
    }
}
JSON;

}
class Client
{
    public function call(
        string $url = Configuration::URL,
        $payload = Configuration::PAYLOAD,
        string $action = Configuration::ACTION
    ): ?object {
        if (is_array($payload)) {
            $payload = json_encode($payload);
        }
        if (!empty($payload)) {
            // SoapClient works with objects(StdClass)
            $payload = json_decode($payload);
        }
        $soapClient = $this->getClient($url);
        $sessionId = $this->getSession($soapClient);
        $args = array_filter([$sessionId, $payload]);
        return $soapClient->$action(...$args);
    }

    public function getClient(string $url): SoapClient
    {
        return new SoapClient(
            $url.'?wsdl',
            [
                'location' => $url,
                'cache_wsdl' => WSDL_CACHE_NONE,
            ]
        );
    }

    public function getSession(SoapClient $client)
    {
        $date = gmdate('Y-m-d H:i:s');
        $merchantCode = Configuration::MERCHANT_CODE;
        $key = Configuration::MERCHANT_KEY;
        $string = strlen($merchantCode).$merchantCode.strlen($date).$date;
        $algo = 'sha256';
        $hash = hash_hmac($algo, $string, $key);
        $client->__setCookie('XDEBUG_SESSION', 'PHPSTORM');
        return $client->login($merchantCode, $date, $hash, $algo);
    }
}
try {
    $client = new Client();
    var_dump($client->call());
} catch (Exception $ex) {
    var_dump($ex);
}

Response parameters

Parameter
Type

Last updated

Was this helpful?