Capture Authorised Payment

This guide is for the deprecated Flex.API. If you are starting with a new integration, please refer to the Guide for the secuconnect API: Link

When you use the "sale" flow, the payment is executed automatically after the customer confirmed. In some cases you still need to wait with delivery. But the contract is closed, and we care for the payment.

When you use the "authorization" flow, the contract is not closed yet. The payment is only authorized and you need to tell us, that we shall capture the payment now.

You can either use the API solution with POST, or the browser solution with GET. The API endpoint to capture the payment is /payment/<hash>/capture. You need no parameters in addition to your API key.

Note: For invoice transactions you must not call /capture before the full delivery! Please study the next two sections for this case.

Example of API solution with POST:

Request

POST /payment/tujevzgobryk3303/capture HTTP/1.1
Host: api-testing.secupay-ag.de
Content-Type: application/json; charset=utf-8;
Accept: application/json
Accept-Charset: utf-8
 
{
  "data": {
    "apikey": "6801fxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx7ace"
  }
}

The browser solution is very similar, but you need to append the API key to the URL. To capture the above transaction your URL is https://api-testing.secupay-ag.de/payment/tujevzgobryk3303/capture/6801fxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx7ace. This will open a transaction overview, and you can capture the payment with a click on a button.

Note: Be aware that the browser might store the API key in the browser history. It must not be revealed to other persons.