Create payment

Request:

# Method: POST, Endpoint: /api/payment
curl -k https://mein.payever.de/api/payment
-X POST
-H "Authorization: Bearer {access_token}"
-d amount="100"
-d fee="10"
-d order_id="900001291100"
-d currency="USD"
-d cart=json_encode(
   array(
     array(
       'name' => 'Some article',
       'price' => '15',
       'quantity' => '3',
       'description' => 'The new article',
       'thumbnail' => 'https://someitem.com/thumbnail.jpg',
       'url' => 'URL to article'
     ),
     array(
       'name' => 'Some item',
       'price' => '15',
       'quantity' => '3',
       'description' => 'The new item in black',
       'thumbnail' => 'https://someitem.com/thumbnail',
       'url' => 'URL to article'
     )
   )
 )
 ,
-d salutation="mr"
-d first_name="John"
-d last_name="Doe"
-d city="New York"
-d zip="10019"
-d street="5th Ave, 342"
-d country="US"
-d email="john.doe@payever.de"
-d phone="+1 (800) 566756"
-d social_security_number="1234567890"
-d success_url="https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--"
-d failure_url="https://www.you.shop.tld/callback/failure/--PAYMENT-ID--\call_id/--CALL-ID--"
-d cancel_url="https://www.you.shop.tld/callback/notice/--PAYMENT-ID--\call_id/--CALL-ID--"
-d notice_url="https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--"
-d pending_url="https://www.you.shop.tld/callback/pending/--PAYMENT-ID--\call_id/--CALL-ID--"
-d x_frame_host="https://your.shop.tld"

<?php

$curl = curl_init();

$cart = array(
   array(
       'name' => 'Some article',
       'price' => '15',
       'priceNetto' => '15',
       'vatRate' => '10',
       'quantity' => '3',
       'description' => 'The new article',
       'thumbnail' => 'https://someitem.com/thumbnail.jpg',
       'sku' => '123',
   ),
   array(
       'name' => 'Some item',
       'price' => '15',
       'priceNetto' => '15',
       'vatRate' => '10',
       'quantity' => '3',
       'description' => 'The new item in black',
       'thumbnail' => 'https://someitem.com/thumbnail',
       'sku' => '124',
   )
);
$params = array(
   'channel' => 'other_shopsystem',
   'amount' => '100',
   'fee' => '10',
   'order_id' => '900001291100',
   'currency' => 'USD',
   'cart' => json_encode($cart),
   'salutation' => 'mr',
   'first_name' => 'John',
   'last_name' => 'Doe',
   'city' => 'New York',
   'zip' => '10019',
   'street' => '5th Ave, 342',
   'country' => 'US',
   'email' => 'john@payever.de',
   'phone' => '+1 (800) 123756',
   'success_url' => 'https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--',
   'failure_url' => 'https://www.you.shop.tld/callback/failure/--PAYMENT-ID--\call_id/--CALL-ID--',
   'cancel_url' => 'https://www.you.shop.tld/callback/notice/--PAYMENT-ID--\call_id/--CALL-ID--',
   'notice_url' => 'https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--',
   'pending_url' => 'https://www.you.shop.tld/callback/pending/--PAYMENT-ID--\call_id/--CALL-ID--',
   'x_frame_host' => 'https://your.shop.tld,',
);


curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $params,
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer <access_token>"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

<?php

$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
));

$request->setContentType('application/x-www-form-urlencoded');

$cart = array(
   array(
       'name' => 'Some article',
       'price' => '15',
       'priceNetto' => '15',
       'vatRate' => '10',
       'quantity' => '3',
       'description' => 'The new article',
       'thumbnail' => 'https://someitem.com/thumbnail.jpg',
       'sku' => '123',
   ),
   array(
       'name' => 'Some item',
       'price' => '15',
       'priceNetto' => '15',
       'vatRate' => '10',
       'quantity' => '3',
       'description' => 'The new item in black',
       'thumbnail' => 'https://someitem.com/thumbnail',
       'sku' => '124',
   )
);

$request->setPostFields(array(
  'access_token' => 'MWVhZjZlMmVmMxNzIzZg',
  'channel' => 'other_shopsystem',
  'amount' => '100',
  'fee' => '10',
  'order_id' => '900001291100',
  'currency' => 'USD',
  'cart' => json_encode($cart),
  'salutation' => 'mr',
  'first_name' => 'John',
  'last_name' => 'Doe',
  'city' => 'New York',
  'zip' => '10019',
  'street' => '5th Ave, 342',
  'country' => 'US',
  'email' => 'john@payever.de',
  'phone' => '+1 (800) 123756',
  'success_url' => 'https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--',
  'failure_url' => 'https://www.you.shop.tld/callback/failure/--PAYMENT-ID--\call_id/--CALL-ID--',
  'cancel_url' => 'https://www.you.shop.tld/callback/notice/--PAYMENT-ID--\call_id/--CALL-ID--',
  'notice_url' => 'https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--',
  'pending_url' => 'https://www.you.shop.tld/callback/pending/--PAYMENT-ID--\call_id/--CALL-ID--',
  'x_frame_host' => 'https://your.shop.tld,',
));

try {
  $response = $request->send();
  echo $response->getBody();

} catch (HttpException $ex) {

  echo $ex;
}

Response:

{
  "call": {
    "id": "d0e7144fcdeac4dcfa7b4eed3206c9cf",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "new",
    "created_at": "2014-05-21T13:52:46+0200",
    "payment_id": "d44c2eb96a608dd61ed9cf7bafa8bd24 - // when payment object was created, means checkout form was submitted successfully",
    "amount": 100,
    "order_id": "900001291100",
    "currency": "USD",
    "cart": "Some Goods",
    "salutation": "SALUTATION_MR",
    "first_name": "John",
    "last_name": "Doe",
    "street": "5th Ave, 342",
    "zip": "10019",
    "city": "New York",
    "country": "US",
    "phone": " 1 (800) 566756",
    "email": "john.doe@payever.de",
    "success_url": "https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--",
    "failure_url": "https://www.you.shop.tld/callback/failure/--PAYMENT-ID--\call_id/--CALL-ID--",
    "cancel_url": "https://www.you.shop.tld/callback/notice/--PAYMENT-ID--\call_id/--CALL-ID--",
    "notice_url": "https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--",
    "pending_url": "https://www.you.shop.tld/callback/pending/--PAYMENT-ID--\call_id/--CALL-ID--",
    "“x_frame_host”": "https://www.you.shop.tld",

    "type": "create"
  },

  "redirect_url": "https://mein.payever.de/shop/payment/api/6f5ee0715cd35f212ec6cce0284aec35"
}

{
  "call": {
    "id": "dac34c66e54ad56c8",
    "status": "new",
    "created_at": "2016­06­20T16:13:15+02:00", "business_id": "super­shop",
    "channel": "o​ther_shopsystem"​,
    "amount": 100,
    "fee": 10,
    "order_id": "900001291100", "currency": "USD",
    "cart": "{}",
    "salutation": "SALUTATION_MR", "first_name": "John", "last_name": "Doe",
    "street": "5th Ave, 342",
    "zip": "10019",
    "city": "New York",
    "country": "US",
    "phone": "+1 (800) 123756",
    "email": "john@payever.de",

    "success_url": "https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--",
    "failure_url": "https://www.you.shop.tld/callback/failure/--PAYMENT-ID--\call_id/--CALL-ID--",
    "cancel_url": "https://www.you.shop.tld/callback/notice/--PAYMENT-ID--\call_id/--CALL-ID--",
    "notice_url": "https://www.you.shop.tld/callback/success/--PAYMENT-ID--\call_id/--CALL-ID--",
    "pending_url": "https://www.you.shop.tld/callback/pending/--PAYMENT-ID--\call_id/--CALL-ID--",
    "“x_frame_host”": "https://www.you.shop.tld",

    "payments": [],
    "type": "create"
  },

  "redirect_url": "https://mein.payever.de/pay/load­api/dac34c66c683ad56c8"
}

Method
POST

Endpoint
/api/payment

The create payment function generates an html snippet (redirect_url) which has to be placed within your checkout. On the snippet, a customer can choose his preferred payment method and finalizes the payment. Most of our attributes are optional but the more you send to our API the less your customer has to enter by himself. To use this function you have to generate an access token for the scope: API_CREATE_PAYMENT.

After the gateway is created you have to redirect the customer to the {redirect_url}.

You can do this either by a real redirect or inject the URL as an iFrame to your cart. We recomment to use the iframe solution.

After a successful transaction, the customer will be redirected to your provided success_url.