AuthorizePayment

Summary

Approves the payment for a specified customer and basket. Main use-cases are One-Step and Two-Step Authorization. Full fraud and credit scoring applied. If the online-shop customer enter the incorrect address data, the system delivers a suggestion for a corrected address.

Resource URL /api/v3/checkout/authorize
HTTP method POST
Content type application/json; text/json;

Input parameters

Parameter name Location Type / Model Description
request body AuthorizePaymentRequest required

Responses

HTTP status code Model Comment
OK(200) AuthorizePaymentResponse Authorize Payment Response
BadRequest (400) array of ResponseMessage Request failed. Check response model for list of Errors.
Unauthorized (401) API user is unauthorized. Make sure X-Auth-Key header is sent.
InternalServerError (500) Request failed due internal error. Retry request later.

Examples

{
  "payment": {
    "type": "Invoice"
  },
  "customer": {
    "salutation": "Mr",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@mail.com",
    "customerCategory": "Person",
    "address": {
      "street": "Gütersloher Str.",
      "streetNumber": "123",
      "postalCode": "33415",
      "postalPlace": "Verl",
      "countryCode": "DE"
    },
    "conversationLanguage": "EN"
  },
  "order": {
    "number": "ORDER000001",
    "totalGrossAmount": 100.00,
    "currency": "EUR",
    "items": [
      {
        "productId": "1",
        "description": "Tablet Black",
        "grossUnitPrice": 40.00,
        "quantity": 2.0
      },
      {
        "productId": "2",
        "description": "MusicPlayer Black",
        "grossUnitPrice": 20.00,
        "quantity": 1.0
      }
    ]
  }
}
{
  "customer": {
    "customerNumber": "000000001",
    "firstName": "John",
    "lastName": "Doe",
    "addressList": [
      {
        "street": "Gütersloher Str.",
        "streetNumber": "123",
        "postalCode": "33415",
        "postalPlace": "Verl",
        "countryCode": "DE"
      }
    ]
  },
  "reservationId": "a9075e1d-7d90-4dde-83f5-0592937192f6",
  "checkoutId": "745b6ba4-fedf-4588-9d35-4612a60782b6"
}