Filter by Payment:

Filter by Language:

Authentication

The authentication to the payever API is done by providing one of your API keys in the request. You can manage your API keys from your account.

You can have multiple API keys active at one time. Your API keys carry many privileges, so be sure to keep them secret. All API requests must be made over HTTPS.

Calls made over plain HTTP will fail. You must authenticate for all requests.

Authentication token can be defined in the HTTP request header or in the URL: Authorization: Bearer {access_code} or /api/payment?access_token={access_code}

Method POST

Endpoint /oauth/v2/token

AttributerequiredDescription
client_idtrueYour payever client_id.
client_secrettrueYour payever client_secret
scopetrueThe scope you want to access. Available are: API_CREATE_PAYMENT: create a new payment
grant_typetrueGrant type is always: http://www.payever.de/api/payment
Request:
# Method: POST
# Endpoint: /oauth/v2/token
 
curl -k https://mein.payever.de/oauth/v2/token 
  -d client_id="{client_id}" 
  -d client_secret="{client_secret}" 
  -d grant_type="http://www.payever.de/api/payment" 
  -d scope="API_CREATE_PAYMENT"
$curl = curl_init();
 
$params = array(
   'client_id' => '12345_client_id_string',
   'client_secret' => 'client_secret_string',
   'grant_type' => 'http://www.payever.de/api/payment',
   'scope' => 'API_CREATE_PAYMENT',
);
curl_setopt_array($curl, array(
   CURLOPT_URL => "https://mein.payever.de/oauth/v2/token",
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
   CURLOPT_POSTFIELDS => $params,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
   echo "cURL Error #:" . $err;
} else {
   echo $response;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/oauth/v2/token');
$request->setMethod(HTTP_METH_POST);
 
$request->setQueryData(array(
  'client_id' => '12345_client_id_string',
  'client_secret' => 'client_secret_string',
  'grant_type' => 'http://www.payever.de/api/payment',
  'scope' => 'API_CREATE_PAYMENT'
));
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
  "access_token": "NWNkODc3ZjFkZWUyZDM1Mzg2Njg2NzMzYjJkOTljYWExYzI3MDAwNzAzYTgyOWYyOWI2ZDc3Z jUxNmJhYTlmYw",
  "expires_in": 3600,
  "token_type": "bearer",
  "scope": "API_CREATE_PAYMENT",
  "refresh_token": "ZWIyZGU4ZDVjOTEwMjczM2FmNzA3ZWUyZGFlZGYzY2UyZjRhMmNkMTQ0NDhhMjc5ZmMzNGNh Mzg5YzFjZjQ4Mw"
}
{
  "access_token": "NWNkODc3ZjFkZWUyZDM1Mzg2Njg2NzMzYjJkOTljYWExYzI3MDAwNzAzYTgyOWYyOWI2ZDc3Z jUxNmJhYTlmYw",
  "expires_in": 3600,
  "token_type": "bearer",
  "scope": "API_CREATE_PAYMENT",
  "refresh_token": "ZWIyZGU4ZDVjOTEwMjczM2FmNzA3ZWUyZGFlZGYzY2UyZjRhMmNkMTQ0NDhhMjc5ZmMzNGNh Mzg5YzFjZjQ4Mw"
}

Create payment

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, the customer chooses his preferred payment method or directly jumps into the payment data if you specify the payment option in the call. 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.

AttributerequiredtypeDescription
channeltruestringChannel type, for example "shopware", "magento", "oxid" etc. Default value is shopware. Please take care, if you have, for example, only magento channel enabled, the use of default value will follow to an error response like "The channel shopware is not enabled". In most cases you will need "other_shopsystem".
channel_set_idfalseintegerThe channel set ID. If not given - the first channel set of the channel selected will be used.
amounttruefloatOrder amount
feefalsefloatShipping fee
order_idtruestring(50 symbols max). ID or reference to identify the order. In case santander_installment payment option (Santander Germany) is forced – 35 symbols max (santander requirement). Please note, if payment option is not forced (customer is free to choose any available payment options) and santander_installment was chosen manually in payment options list – the order_id will be cut out to 35 symbols automatically.
currencytruestring3 Letter ISO currency code
carttruearrayCart items with name, description, quantity, price, thumbnail and url to article
payment_methodfalsestringSelect between cash, santander_installment, santander_ccp_installment, santander_installment_dk, santander_installment_no, santander_invoice_no, santander_installment_se, invoice, stripe, stripe_directdebit, sofort, paypal, payex_creditcard, payex_faktura, paymill_creditcard and paymill_directdebit. If not specified, the payment page will contain a list of available payment options, and customer will be able to select one of them.
salutationfalsestringThe customer’s salutation, mr / mrs*
first_namefalsestringThe customer’s first name
last_namefalsestringThe customer’s last name
streetfalsestringThe street of the customer’s shipping address
zipfalsestringThe zip of the customer’s shipping address
cityfalsestringThe city of customer’s shipping address
countryfalsestring2 Letter ISO country code
social_security_numberfalsestringSocial Security Number. Currently supported Sweden social security numbers.
birthdatefalseDateTimeThe customer´s birthdate
phonefalsestringThe customer´s phone number
emailfalsestringThe customer’s email address
success_urlfalsestringURL to redirect customer on successful transaction. You can add --PAYMENT-ID-- and --CALL-ID-- as a placeholder to catch the right payment on redirect. E.g. https://yourshop.com/success.php?payment_id=--PAYMENT-ID--&call_id=--CALL-ID--(query string parameters way) or https://yourshop.com/success.php/payment_id/--PAYMENT-ID--/call_id/--CALL-ID-- Please note, CALL_ID and PAYMENT_ID placeholders are not required to be used in the url, they are just a helpful information. For example, if you don’t have a way to identify your cart payment inside your system – use our CALL_ID. The PAYMENT_ID will return our payment transaction identifier, can be helpful to retrieve the full payment details via API later.
pending_urlfalsestringURL to redirect customer on failed transaction. You can add --PAYMENT-ID-- and --CALL-ID-- as a placeholder to catch the right payment on redirect. E.g. https://yourshop.com/failure.php?payment_id=--PAYMENT-ID--
failure_urlfalsestringURL to redirect customer on failed transaction. You can add --PAYMENT-ID-- and --CALL-ID-- as a placeholder to catch the right payment on redirect. E.g. https://yourshop.com/failure.php?payment_id=--PAYMENT-ID--
cancel_urlfalsestringURL to redirect customer on transaction that are on hold. You can add --PAYMENT-ID-- and --CALL-ID-- as a placeholder to catch the right payment on redirect. E.g. https://yourshop.com/pending.php?payment_id=--PAYMENT-ID--
notice_urlfalsestringURL for notifications about occured transactions. Any changes in transaction (mostly status changes) will be sent to this URL using POST request with JSON payload.
x_frame_hostfalsestringx_frame_host (required) false (type) string (description) "URL for Content-Security-Policy and X-Frame-Options ALLOW_FROM headers that will be added to the payment iframe. success/pending/notice/failure/cancel url will be used if x_frame_host was no sent. If no one callback url was provided self headers will be added: Content-Security-Policy frame-ancestors 'self' and X-Frame-Options SAMEORIGIN
plugin_versionfalsestringJust the statistical information about your code/plugin version
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"
$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 "
  ),
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
$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"
}

Retrieve payment

Method GET

Endpoint /api/payment/{id}

The retrieve payment function retrieves all information for a specific payment. You can use this function to update the status of a payment within your cart. To use this function you have to generate an access token.

AttributerequiredtypeDescription
access_tokentruestringTo retrieve a payment you have to generate an access token
payment_idtruestringTo retrieve a specific payment you have to provide its payment_id. You obtain the payment_id by creating our gateway or by retrieving a list of previous made payments.
Request:
curl -k https://mein.payever.de/api/payment/{payment_id} 
-X GET
-H "Authorization: Bearer {access_token}"
$curl = curl_init();
$params = array(
    'access_token' => 'YjI5ZDYxMzBOTAwZA'
);
 
curl_setopt_array( $curl, array(
    CURLOPT_URL => "https://mein.payever.de/api/payment/153af899a8cb787e60caf",
 
    CURLOPT_POST => false,
    CURLOPT_HTTPHEADER => array( "Authorization: Bearer " ),
 
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  )
);
 
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
$request = new HttpRequest();
$request­>setUrl('https://mein.payever.de/api/payment/153af899a8cb787e60caf');
$request­>setMethod(HTTP_METH_GET);
$request­>setQueryData(array( 'access_token' => 'YjI5ZDYxMzBOTAwZA'));
 
try {
 
  $response = $request­>send();
  echo $response­>getBody();
 
} catch (HttpException $ex) {
 
  echo $ex;
}
Response:
{
  "call": {
    "id": "d8a6079d7e9ca4d164dc0ceacc5ca050",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-05-21T14:52:02+0200",
    "payment_id": 0
  },
  "result": {
    "id": "d44c2eb96a608dd61ed9cf7bafa8bd24",
    "status": "STATUS_NEW",
    "merchant_name": "Martin Saigger",
    "customer_name": "John Doe",
    "payment_type": "santander_installment",
    "created_at": "2014-05-21T14:10:29+0200",
    "updated_at": "2014-05-21T14:10:29+0200",
    "reference": "900001291100",
    "amount": 1000,
    "fee": 99.9,
    "payment_details": {
 
    }
  }
}
{
  "call": {
    "id": "a12f1c87db06a173",
    "status": "success",
    "created_at": "2016­06­21T12:25:41+02:00",
    "business_id": "super­shop"
  },
  "result": {
    "id": "153af899a2787e60caf",
    "status": "STATUS_NEW",
    "color_state": "yellow",
    "merchant_name": "Super shop",
    "customer_name": "Roma",
    "payment_type": "paypal",
    "created_at": "2016­06­07T21:41:29+02:00",
    "updated_at": "2016­06­07T21:41:29+02:00",
    "channel": "store",
    "reference": "212ce8616fee0bfd",
    "amount": 4,
    "currency": "EUR",
    "fee": 0.43,
    "total": 4,
    "address": {
      "id": 74,
      "country": "DE",
      "country_name": "Germany",
      "city": "Men",
      "zip_code": "873",
      "street": "Graeg",
      "street_number": "75",
      "salutation": "SALUTATION_MR",
      "first_name": "Roman",
      "last_name": "Q",
      "type": "shipping"
    },
    "payment_details": {
      "prefilled": false
    }
  }
}

List payments

Method GET

Endpoint /api/payment

The list payment function responds an array with a specific set of transactions made with your account. To use this function you have to generate an access token.

AttributerequiredtypeDescription
access_tokentruestringTo retrieve a payment, you have to generate an access_token.
payment_methodfalsestringRetrieve only transactions for the given payment_method. Available are cash, santander installment, invoice, paypal, stripe, direct debit and sofort.
datefalseDateTimeRetrieve only transactions for the given date.
currencyfalsestringRetrieve only payments with the given currency.
statefalsestringRetrieve only payments with the given state. These are the ones available: STATUS_NEW, STATUS_IN_PROCESS, STATUS_ACCEPTED, STATUS_FAILED, STATUS_DECLINED, STATUS_IN_COLLECTION and STATUS_LATEPAYMENT
limitfalsestringLimit the output of retrieved transactions. By default the last 10 transactions matching the given values are responded.
Request:
curl -k https://mein.payever.de/api/payment?limit=50
-X GET
-H "Authorization: Bearer {access_token}"
$curl = curl_init();
$params = array(
  'limit' => '50 ',
  'access_token' => 'YTc2NjI4ZTYyM2Q5Mjk4ZQ',
  'payment_type' => 'paypal',
  'currency' => 'EUR',
  'state' => 'STATUS_NEW',
  'date' => '2016­06­20T16'
);
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment",
  CURLOPT_POSTFIELDS => $params,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
}
else {
  echo $response;
}
 
$request = new HttpRequest();
$request­ > setUrl('https://mein.payever.de/api/payment');
$request­ > setMethod(HTTP_METH_GET);
$request­ > setQueryData(array(
  'limit' => '50 ',
  'access_token' => 'YTc2NjI4ZTYyM2Q5Mjk4ZQ',
  'payment_type' => 'paypal',
  'currency' => 'EUR',
  'state' => 'STATUS_NEW',
  'date' => '2016­06­20T16'
));
try {
  $response = $request­ > send();
  echo $response­ > getBody();
}
 
catch(HttpException $ex) {
  echo $ex;
}
Response:
 {
  "call": {
    "id": "195b2548d02c32b3da928b60455e832f",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-05-09T17:03:18+0200",
    "limit": 5
  },
  "result": [
    {
      "id": 157,
      "status": "STATUS_ACCEPTED",
      "merchant_name": "Some Merchant",
      "customer_name": "John Doe",
      "payment_type": "invoice",
      "last_action": "INVOICE_TRANSFER",
      "created_at": "2014-05-09T10:11:48+0200",
      "updated_at": "2014-05-09T14:54:35+0200",
      "reference": "900001291100",
      "amount": 100
    },
    {
 
    }
  ]
}
{
  "call": {
    "id": "ab8ae1fc1d287",
    "status": "success",
    "created_at": "2016­06­20T16:33:09+02:00",
    "business_id": "super­shop",
    "currency": "EUR",
    "state": "STATUS_NEW",
    "limit": 50
  },
  "result": [
    {
      "id": "153afe60caf",
      "status": "STATUS_NEW",
      "color_state": "yellow",
      "merchant_name": "Super shop",
      "customer_name": "Roman QA2",
      "payment_type": "paypal",
      "created_at": "2016­06­07T21:41:29+02:00",
      "updated_at": "2016­06­07T21:41:29+02:00",
      "channel": "store",
      "reference": "212ce8ee0bfd",
      "amount": 4,
      "currency": "EUR",
      "fee": 0.43,
      "total": 4,
      "address": {
        "id": 7444,
        "country": "DE",
        "country_name": "Germany",
        "city": "München",
        "zip_code": "8373",
        "street": "Grweg",
        "street_number": "745",
        "salutation": "SALUTATION_MR",
        "first_name": "Roman",
        "last_name": "QA2",
        "type": "shipping"
      }
    }
  ],
  "redirect_url": "https://mein.payever.de/shop/payment/api/6f5ee84aec35"
}

Edit payment

Method POST

Endpoint /api/payment/edit/{payment_id}

The edit payment method edits a payment. This function is only available for Santander Norway and Denmark. To use this function you have to generate an access token.

AttributerequiredtypeDescription
amountfalsefloatSpecify the new amount.
Request:
 curl -k https://mein.payever.de/api/payment/edit/{payment_id} 
-X POST 
-H "Authorization: Bearer {access_token}" 
-d amount="50"
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment/refund/153af899a81c2787e60caf",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => "amount=50&access_token=MjE3MzExYjMWY2NzI1MQ",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer "
  ) ,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
}
else {
  echo $response;
}
 
//'access_token' = 'MjE3MzExYjZiNWNzI1MQ'
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment/edit/153af8960caf');
$request->setMethod(HTTP_METH_POST);
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
  'Authorization' => 'Bearer '
));
$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'amount' => '50',
 
));
try {
  $response = $request->send();
  echo $response->getBody();
}
 
catch(HttpException $ex) {
  echo $ex;
}
Response:
{
  "call": {
    "id": "456d307932af3a099ec625132ee3ae9c",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-06-04T10:47:06+02:00",
    "payment_id": "48b89a6f9c6f48fc765830a69032682e",
    "amount": 50,
    "type": "edit"
  },
  "result": {
 
  }
}
{
  "call": {
    "id": "fe1ae99f8ac0aa86ce5a8c",
    "status": "success",
    "created_at": "2016-06-22T17:38:23+02:00",
    "business_id": "super-shop",
    "payment_id": "153af899a81c2787e60caf",
    "amount": 50,
    "type": "edit"
  }
}

Cancel payment

Method POST

Endpoint /api/payment/cancel/{payment_id}

With this function you can cancel the payment which wasn't failed or canceled previously. To use this function you have to generate an access token

none: This function does not need any attributes.

Request:
 curl -k https://mein.payever.de/api/cancel/95d9e75fecabfaf563c63ef5cf232830 
-X POST 
-H "Authorization: Bearer {access_token}"
//'access_token' => 'N2ViNTEwZjM0NTiYmVhMg'
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment/cancel/153af8991c2787e60caf",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => "access_token=N2ViNTEw5NGI5ZTliYmVhMg",
  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;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment/cancel/153af899a8e60caf');
$request->setMethod(HTTP_METH_POST);
 
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
  'Authorization' => 'Bearer {access_token}',
));
 
$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array());
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
    "call": {
        "id": "76f57db32417970ad0661de37d9b285a",
        "status": "success",
        "created_at": "2016-06-21T06:35:20+00:00",
        "business_id": "demoshop",
        "payment_id": "95d9e75fecabfaf563c63ef5cf232830",
        "type": "cancel"
    },
    "result": {
        "id": "95d9e75fecabfaf563c63ef5cf232830",
        "status": "STATUS_CANCELLED",
        "color_state": "red",
        "merchant_name": "Demoshop",
        "customer_name": "Artur Schlaht",
        "payment_type": "santander_installment_no",
        "last_action": "INVOICE_CANCELLATION",
        "created_at": "2016-04-03T18:07:57+00:00",
        "updated_at": "2016-06-21T06:35:24+00:00",
        "channel": "shopware",
        "channel_set": {
            "id": 2619,
            "name": "Shopware",
            "slug": "demoshop-norway/shopware/shopware",
            "configured": true,
            "created_at": "2016-03-14T08:40:32+00:00",
            "updated_at": "2016-06-21T06:35:20+00:00",
            "discr": "shopware"
        },
        "reference": "LEXINGTON (SW10016)",
        "items": [],
        "amount": 6990,
        "currency": "NOK",
        "fee": 0,
        "other_fees": 0,
        "payever_commission": 0,
        "total": 6990,
        "address": {
            "full_street": "Vitaminveien 7 - 9",
            "id": 8436,
            "country": "NO",
            "country_name": "Norway",
            "city": "Oslo",
            "zip_code": "0485",
            "street": "Vitaminveien",
            "street_number": "7 - 9",
            "salutation": "SALUTATION_MR",
            "first_name": "Artur",
            "last_name": "Schlaht",
            "type": "shipping"
        },
        "payment_details": {
            "specific_status": "CANCELLED",
            "id": 3368,
            "delivery_fee": 0,
            "payment_fee": 0,
            "email": "superpenguin@gmx.net",
            "prefilled": false,
            "student": false,
            "credit_type": "HANDLEKONTO",
            "campaign_code": "TWO_MONTH_199",
            "application_number": "152102",
            "monthly_amount": "0.00",
            "credit_duration_in_months": 0,
            "credit_calculation": {
                "product_type": "HANDLEKONTO",
                "campaign_code": "TWO_MONTH_199",
                "credit_duration": "0",
                "kid": "094027006991",
                "status_code": "PROCESSING",
                "status_description": "Under behandling",
                "approved": false,
                "decision_made": false,
                "final": false,
                "paid": false,
                "flow_status_code": "ERROR"
            },
            "discr": "santander_no_installment"
        }
    }
}
{
    "call": {
        "id": "76f57db32417970ad0661de37d9b285a",
        "status": "success",
        "created_at": "2016-06-21T06:35:20+00:00",
        "business_id": "demoshop",
        "payment_id": "95d9e75fecabfaf563c63ef5cf232830",
        "type": "cancel"
    },
    "result": {
        "id": "95d9e75fecabfaf563c63ef5cf232830",
        "status": "STATUS_CANCELLED",
        "color_state": "red",
        "merchant_name": "Demoshop",
        "customer_name": "Artur Schlaht",
        "payment_type": "santander_installment_no",
        "last_action": "INVOICE_CANCELLATION",
        "created_at": "2016-04-03T18:07:57+00:00",
        "updated_at": "2016-06-21T06:35:24+00:00",
        "channel": "shopware",
        "channel_set": {
            "id": 2619,
            "name": "Shopware",
            "slug": "demoshop-norway/shopware/shopware",
            "configured": true,
            "created_at": "2016-03-14T08:40:32+00:00",
            "updated_at": "2016-06-21T06:35:20+00:00",
            "discr": "shopware"
        },
        "reference": "LEXINGTON (SW10016)",
        "items": [],
        "amount": 6990,
        "currency": "NOK",
        "fee": 0,
        "other_fees": 0,
        "payever_commission": 0,
        "total": 6990,
        "address": {
            "full_street": "Vitaminveien 7 - 9",
            "id": 8436,
            "country": "NO",
            "country_name": "Norway",
            "city": "Oslo",
            "zip_code": "0485",
            "street": "Vitaminveien",
            "street_number": "7 - 9",
            "salutation": "SALUTATION_MR",
            "first_name": "Artur",
            "last_name": "Schlaht",
            "type": "shipping"
        },
        "payment_details": {
            "specific_status": "CANCELLED",
            "id": 3368,
            "delivery_fee": 0,
            "payment_fee": 0,
            "email": "superpenguin@gmx.net",
            "prefilled": false,
            "student": false,
            "credit_type": "HANDLEKONTO",
            "campaign_code": "TWO_MONTH_199",
            "application_number": "152102",
            "monthly_amount": "0.00",
            "credit_duration_in_months": 0,
            "credit_calculation": {
                "product_type": "HANDLEKONTO",
                "campaign_code": "TWO_MONTH_199",
                "credit_duration": "0",
                "kid": "094027006991",
                "status_code": "PROCESSING",
                "status_description": "Under behandling",
                "approved": false,
                "decision_made": false,
                "final": false,
                "paid": false,
                "flow_status_code": "ERROR"
            },
            "discr": "santander_no_installment"
        }
    }
}

Refund payment

Method POST

Endpoint /api/payment/refund/{payment_id}

The refund payment method refunds a payment completely or partially. This function is only available for invoice payments. To use this function you have to generate an access token.

AttributerequiredtypeDescription
amountfalsefloatSpecify the refund amount. If no amount is set, the whole amount will be refunded. It depends on the payment method if you have to take further action like wire-transfer the amount to the customer for invoice payments.
Request:
 curl -k https://mein.payever.de/api/payment/refund/{payment_id} 
-X POST 
-H "Authorization: Bearer {access_token}" 
-d amount="50"
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment/refund/153af899a81c2787e60caf",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => "amount=50&access_token=MjE3MzExYjMWY2NzI1MQ",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer "
  ) ,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
}
else {
  echo $response;
}
 
//'access_token' = 'MjE3MzExYjZiNWNzI1MQ'
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment/refund/153af8960caf');
$request->setMethod(HTTP_METH_POST);
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
  'Authorization' => 'Bearer '
));
$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'amount' => '50',
 
));
try {
  $response = $request->send();
  echo $response->getBody();
}
 
catch(HttpException $ex) {
  echo $ex;
}
Response:
{
  "call": {
    "id": "456d307932af3a099ec625132ee3ae9c",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-06-04T10:47:06+02:00",
    "payment_id": "48b89a6f9c6f48fc765830a69032682e",
    "amount": 50,
    "type": "refund"
  },
  "result": {
 
  }
}
{
  "call": {
    "id": "fe1ae99f8ac0aa86ce5a8c",
    "status": "success",
    "created_at": "2016-06-22T17:38:23+02:00",
    "business_id": "super-shop",
    "payment_id": "153af899a81c2787e60caf",
    "amount": 50,
    "type": "refund"
  }
}

Authorize payment

Method POST

Endpoint /api/payment/authorize/{payment_id}

Authorize a previously made payment. This function is only available for invoice payments. To use this function you have to generate an access token.

AttributerequiredtypeDescription
customer_idfalsestringThe customer ID from your System. If nothing is set we use our own customer ID.
invoice_idfalsestringThe invoice ID from your System. If nothing is set we use the generated payment_id.
invoice_datefalsedateTimeThe Date you generated and shipped the invoice. If nothing is set we use the current date.
Request:
 curl -k https://mein.payever.de/api/payment/authorize/48b89a6f9c6f48fc765830a69032682e 
-X POST 
-H "Authorization: Bearer {access_token}" 
-d customer_id="328" 
-d invoice_id="1000098991" 
-d invoice_date="2014-05-21"
//'access_token' => 'ZGJmGRkYjAwZA',
 
$curl = curl_init();
$params = array(
  'customer_id' => '328',
  'invoice_id' => '100',
  'invoice_date' => '2016-05-21T00:00:00+02:00'
);
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment/authorize/6b8687b7b1edcfc",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $params,
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer "
  ),
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
//'access_token' => 'ZGJmGRkYjAwZA',
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment/authorize/6b8687be1edcfc');
$request->setMethod(HTTP_METH_POST);
 
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
  'Authorization' => 'Bearer '
));
 
$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'customer_id' => '328',
  'invoice_id' => '100',
  'invoice_date' => '2016-05-21T00:00:00+02:00'
));
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
"call":
  {
    "id": "b58b1c28f14ddb625c0ffd2ceca75f6e",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-06-04T11:37:02+02:00",
    "payment_id": "12926734411fa4a1b82b46e7194990f0",
    "customer_id": "328",
    "invoice_id": "100",
    "invoice_date": "2014-05-21T00:00:00+02:00",
    "type": "authorize"
  },
  "result": {}
}
{
  "call": {
    "id": "e98ff776106a3d7a00ee",
    "status": "success",
    "created_at": "2016-06-22T17:31:10+02:00",
    "business_id": "super-shop",
    "payment_id": "153af8991c2787e60caf",
    "customer_id": "328",
    "invoice_id": "100",
    "invoice_date": "2016-05-21T00:00:00+02:00",
    "type": "authorize"
  }
}

Shipping goods payment

Method POST

Endpoint /api/payment/shipping-goods/{payment_id}

With this function you can notify that the goods were delivered. This function is only allowed to be send one time and it's only available for Santander payments. To use this function you have to generate an access token.

none: This function does not need any attributes.

Request:
 curl -k https://mein.payever.de/api/shipping-goods/6ffd39faba130015e443d8b7d9e07995 
-X POST 
-H "Authorization: Bearer {access_token}"
//'access_token' => 'ZGJmGRkYjAwZA',
$curl = curl_init();
 
$params = array(
  'customer_id' => '328',
  'invoice_id' => '100',
  'invoice_date' => '2016-05-21T00:00:00+02:00'
);
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/payment/shipping-goods/6b8687b7b1edcfc",
  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;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/payment/shipping-goods/6b8687b7b1edcfc');
$request->setMethod(HTTP_METH_POST);
 
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded',
  'Authorization' => 'Bearer {access_token}',
));
 
$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'customer_id' => '328',
  'invoice_id' => '100',
  'invoice_date' => '2016-05-21T00:00:00+02:00'
));
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
"call":
  {
    "id": "b58b1c28f14ddb625c0ffd2ceca75f6e",
    "shop_id": "31012408fad6abc962c5af237e1bb930",
    "status": "success",
    "created_at": "2014-06-04T11:37:02+02:00",
    "payment_id": "12926734411fa4a1b82b46e7194990f0",
    "customer_id": "328",
    "invoice_id": "100",
    "invoice_date": "2014-05-21T00:00:00+02:00",
    "type": "shipping-goods"
  },
  "result": {}
}
{
  "call":{
    "business_id":"super-shop",
    "created_at":"2016-06-24T15:34:32+00:00",
    "id":"d8ef167e56a1",
    "payment_id":"15596b20532422bf",
    "status":"success",
    "type":"shipping_goods"
  },
  "result":{
    "address":{
      "city":"München",
      "country":"DE",
      "country_name":"Germany",
      "first_name":"R",
      "full_street":"Arnulfstraße 1",
      "id":362,
      "last_name":"Test",
      "salutation":"SALUTATION_MR",
      "street":"Arnulfstraße",
      "street_number":"1",
      "type":"billing",
      "zip_code":"12345"
    },
    "amount":123,
    "channel":"santander",
    "channel_set":{
      "configured":true,
      "created_at":"2015-07-28T15:22:17+00:00",
      "discr":"santander",
      "id":19,
      "name":"Default set",
      "slug":"31012c5af237e1bb930-2/santander/default-set",
      "updated_at":"2016-06-24T15:34:32+00:00"
    },
    "color_state":"yellow",
    "created_at":"2015-10-07T22:19:25+00:00",
    "currency":"EUR",
    "customer_name":"R Test",
    "fee":0,
    "id":"15599525c6b20532422bf",
    "items":[],
    "last_action":"INVOICE_TRANSFER",
    "merchant_name":"Test Test",
    "other_fees":0,
    "payever_commission":0,
    "payment_details": {
      "_e_u":[ 0, 3, 41, 6 ],
      "accept_terms_credit_europe":true,
      "application_no":"3500181007221900",
      "application_status":"IN_PROCESS",
      "bank_details_selection":"account_number_bank_code",
      "credit_accepts_requests_to_credit_agencies":false,
      "credit_calculation":{
        "bank_interest":34.259999999999998,
        "cpi_amount":30,
        "duration":6,
        "interest_rate":9.9000000000000004,
        "monthly_rate":26.210000000000001,
        "price":123,
        "rate_pa":7.7009999999999996,
        "total_amount":157.25999999999999
      },
      "credit_confirms_self_initiative":true,
      "credit_due_date":1,
      "credit_duration_in_months":6,
      "credit_protection_insurance":true,
      "delivery_fee":0,
      "discr":"santander_installment",
      "email":"r2@m.info",
      "employment_limited":false,
      "finance_id":"1140972",
      "freelancer":false,
      "id":2449,
      "initial_payment":0,
      "payment_fee":0,
      "personal_date_of_birth":"1990-02-01T00:00:00+00:00",
      "prefilled":false,
      "prev_address":false,
      "prev_employment_details":false,
      "specific_status":"STATUS_SANTANDER_IN_PROCESS"
    },
    "payment_type":"santander_installment",
    "reference":"sdf",
    "status":"STATUS_IN_PROCESS",
    "total":123,
    "updated_at":"2016-06-24T15:34:39+00:00"
  }
}

List Payment Options

Method GET

Endpoint /api/shop/{slug}/payment-options/{channel}

With this function you can get payment options accessible in the shop. Since payment options are public information, there are no security headers required.

ParameterRequiredDescription
slugRequiredThe shop slug, like shop-1
channel-set-idOptionalChannel type. Default value is shopware, first channel set will be used

Or, another way, experimental:

Method GET

Endpoint /api/shop/{slug}/payment-options/{channel-set-id}

ParameterRequiredDescription
slugRequiredThe shop slug
channel-set-idOptionalChannel set ID. Since the access point url is the same as previous, by default will be used first channel set of shopware channel

none: This function does not need any attributes.

Request:
curl -X GET https://mein.payever.de/api/shop/{slug}/payment-options
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/shop/super-shop/payment-options/other_shopsystem",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/shop/super-shop/payment-options/other_shopsystem');
$request->setMethod(HTTP_METH_GET);
 
try {
    $response = $request->send();
 
    echo $response->getBody();
}
catch (HttpException $ex) {
    echo $ex;
}
 
$curl = curl_init();
 
curl_setopt_array($curl, array(
    CURLOPT_URL => "https://mein.payever.de/api/shop/super-shop/payment-options/other_shopsystem",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/shop/super-shop/payment-options/other_shopsystem');
$request->setMethod(HTTP_METH_GET);
 
try {
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex) {
    echo $ex;
}
Response:
{
  "call": {
    "id": "callid",
    "status": "success | failed",
    "created_at": "20001-01-26T18:00:00+00:00",
    "shop_id": "shop-slug",
    "action": "list_payment_options",
    "channel": "shopware",
    "type": "shop_info_list_payment_options",
    "result": [
      {
        "id": "123221",
        "name": "Stripe",
        "status": "active",
        "variable_fee": 1.23,
        "fixed_fee": 2.34,
        "accept_fee": "boolean",
        "description_offer": "Lorem ipsum",
        "description_fee": "Lorem ipsum",
        "min": 0,
        "max": 100000,
        "payment_method": "stripe",
        "type": "payment",
        "slug": "stripe",
        "thumbnail1": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
        "thumbnail2": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
        "thumbnail3": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
        "options": {
          "currencies": [
            "EUR",
            "GBP",
            "USD"
          ],
          "countries": [
            "DE",
            "AT",
            "ES"
          ],
          "actions": [
            "refund",
            "authorize",
            "remind",
            "collect",
            "late_payment"
          ]
        },
        "translations": [
          {
            "locale": "en",
            "field": "conditions",
            "content": "Lorem Ipsum"
          }
        ]
      }
    ]
  }
{
  "{ "callcall": ": {
    "{ "idid": ": "aac8932020bcdf95ffc""aac89320 ,
    "status": "success",
    "created_at": "2016-06-22T17:35:45+02:00",
    "business_id": "super-shop",
    "action": "list_payment_options",
    "channel": "other_shopsystem",
    "channel_set": {
      "id": 3325,
      "name": "Other ShopSystem",
      "slug": "super-shop/other-shopsystem/other-shopsystem",
      "configured": true,
      "created_at": "2016-06-20T17:59:11+02:00",
      "updated_at": "2016-06-22T17:30:22+02:00",
      "discr": "other_shopsystem"
    },
    "type": "shop_info_list_payment_options"
  },
  "result": [
    {
      "id": "12321",
      "name": "Stripe",
      "status": "active",
      "variable_fee": 1.23,
      "fixed_fee": 2.34,
      "accept_fee": "boolean",
      "description_offer": "Lorem ipsum",
      "description_fee": "Lorem ipsum",
      "min": 0,
      "max": 100000,
      "payment_method": "stripe",
      "type": "payment",
      "slug": "stripe",
      "thumbnail1": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
      "thumbnail2": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
      "thumbnail3": "https://mein.payever.de/media/cache/payment_option.list_icon/207120b7bb406bc4024b68c3d0f7142a.png",
      "options": {
        "currencies": [
          "EUR",
          "GBP",
          "USD"
        ],
        "countries": [
          "DE",
          "AT",
          "ES"
        ],
        "actions": [
          "refund",
          "authorize",
          "remind",
          "collect",
          "late_payment"
        ]
      },
      "translations": [
        {
          "locale": "en",
          "field": "conditions",
          "content": "Lorem Ipsum"
        }
      ]
    }
  ]
}

Retrieve API call

Method GET

Endpoint/api/{id}

Returns serialized API call record. Can be used to retrieve payment create API call and read there status and payment failure message if payment was failed.

Important! This access point does not require authentication to retrieve API calls made to access points with public visibility, like /api/shop/{slug}/channel-sets.

For secured calls use access token: create a new one as in Authentication chapter or token used in the target api call.

Request:
curl -X GET https://mein.payever.de/api/66f692d79714c2545683d3ebe262013a
 
curl 
  -X GET https://mein.payever.de/api/66f692d79714c2545683d3ebe262013a?access_token={access_token}
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/aba9f0d333c95da172",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/aba9f0d333c95da172');
$request->setMethod(HTTP_METH_GET);
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
  "id": "66f692d79714c2545683d3ebe262013a",
  "status": "success",
  "created_at": "2015-09-24T14:19:46+02:00",
  "shop_id": "your-shop-slug",
  "action": "list_channel_sets",
  "type": "list_channel_sets"
}
{
  "id": "aba9f0d333c95da172",
  "status": "success",
  "created_at": "2016-06-22T18:42:41+02:00",
  "business_id": "super-shop",
  "action": "list_channel_sets",
  "type": "list_channel_sets"
}

List Channel sets

MethodGET Endpoint/api/shop/{slug}/channel-sets

ParameterRequiredDescription
slugRequiredThe shop slug, like shop-1
Request:
curl -X GET https://mein.payever.de/api/shop/{slug}/channel-sets
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://mein.payever.de/api/shop/super-shop/channel-sets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
));
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
 
$request = new HttpRequest();
$request->setUrl('https://mein.payever.de/api/shop/super-shop/channel-sets');
$request->setMethod(HTTP_METH_GET);
 
try {
  $response = $request->send();
 
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
Response:
{
  "call": {
    "id": "66f692d79714c2545683d3ebe262013a",
    "status": "success",
    "created_at": "2015-09-24T14:19:46+02:00",
    "shop_id": "your-shop-slug"
  },
  "result": [
    {
      "channel_type": "shopware",
      "channel_sets": [
        {
          "id": 123,
          "name": "Default set",
          "slug": "your-shop-slug/shopware/default-set",
          "configured": true,
          "created_at": "2010-09-24T14:01:17+00:00",
          "updated_at": "2010-09-25T14:01:17+00:00"
        }
      ],
      "enabled": true
    }
  ]
}
{
  "call": {
    "id": "aba9f0d333c95da172",
    "status": "success",
    "created_at": "2016-06-22T18:42:41+02:00",
    "business_id": "super-shop"
  },
  "result": [
    {
      "id": 2307,
      "channel_type": "checkout",
      "channel_sets": [
        {
          "id": 1908,
          "name": "default",
          "slug": "super-shop/super-shop-checkout/super-shop-checkout-default",
          "configured": false,
          "created_at": "2016-01-28T08:03:16+01:00",
          "updated_at": "2016-06-07T21:39:33+02:00"
        }
      ],
      "enabled": true
    },
    {
      "id": 2308,
      "channel_type": "store",
      "channel_sets": [
        {
          "id": 2340,
          "name": "Store",
          "slug": "super-shop/store/store",
          "configured": true,
          "created_at": "2016-02-18T19:36:38+01:00",
          "updated_at": "2016-06-22T18:08:21+02:00",
          "store": {
            "id": 590,
            "name": "Store",
            "shipping_price": 0,
            "currency": "EUR",
            "live": false,
            "primary_language": "en",
            "languages": [
              "en",
              "de",
              "es"
            ],
            "hidden": false,
            "logo_url": null
          }
        }
      ],
      "enabled": true
    },
    {
      "id": 2309,
      "channel_type": "marketing",
      "channel_sets": [],
      "enabled": true
    },
    {
      "id": 4183,
      "channel_type": "pos",
      "channel_sets": [],
      "enabled": true
    },
    {
      "id": 6141,
      "channel_type": "magento",
      "channel_sets": [
        {
          "id": 3324,
          "name": "Magento",
          "slug": "super-shop/magento/magento",
          "configured": true,
          "created_at": "2016-06-20T16:10:31+02:00",
          "updated_at": "2016-06-22T14:43:47+02:00"
        }
      ],
      "enabled": true
    },
    {
      "id": 6142,
      "channel_type": "e-conomic",
      "channel_sets": [
        {
          "id": 3323,
          "name": "E-Conomic",
          "slug": "super-shop/e-conomic/e-conomic",
          "configured": false,
          "created_at": "2016-06-20T16:06:06+02:00",
          "updated_at": "2016-06-20T16:06:24+02:00"
        }
      ],
      "enabled": true
    },
    {
      "id": 6143,
      "channel_type": "other_shopsystem",
      "channel_sets": [
        {
          "id": 3325,
          "name": "Other ShopSystem",
          "slug": "super-shop/other-shopsystem/other-shopsystem",
          "configured": true,
          "created_at": "2016-06-20T17:59:11+02:00",
          "updated_at": "2016-06-22T17:30:22+02:00"
        }
      ],
      "enabled": true
    }
  ]
}

Changelog Version 1.3

September 24, 2015

  • Add channel and channel_set_id attributes to Payment Create
  • Add endpoint: list payment options per channel set
  • Add endpoint: list shop channel sets
  • Add endpoint: retrieve API call

Changelog Version 1.2

Fixes in payment options list:

  • attribute fix_fee renamed to fixed_fee
  • added accept_fee attribute

Fixes in create payment call:

  • added new attribute plugin_version

Changelog Version 1.1

Implementation of the following API functions:

  • refund
  • authorize
  • remind
  • collect
  • late-payment

Response value changed for create payment function:

{redirect_url} will now give the complete redirect_url. It is no longer necessary to add the host https://mein.payever.de in front of the received redirect_url.

Changelog Version 1.0

Implementation of the following API functions:

  • authenticate
  • create payment
  • retrieve payment
  • list payments