Checkouts

Deactivate a checkout

Deactivates an identified checkout resource. If the checkout has already been processed it can not be deactivated.

delete/v0.1/checkouts/{id}

Response

OK

amountnumber float

Amount of the payment.

checkout_referencestring

Unique ID of the payment checkout specified by the client application when creating the checkout resource.

currency'BGN' | 'BRL' | 'CHF' | 'CLP' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HRK' | 'HUF' | 'NOK' | 'PLN' | 'RON' | 'SEK' | 'USD'

Three-letter ISO4217 code of the currency for the amount. Currently supported currency values are enumerated above.

datestring date-time

Date and time of the creation of the payment checkout. Response format expressed according to ISO8601 code.

descriptionstring

Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.

idstring

Unique ID of the checkout resource.

merchant_codestring

Unique identifying code of the merchant profile.

merchant_countrystring

The merchant's country

merchant_namestring

Merchant name

pay_to_emailstring email

Email address of the registered user (merchant) to whom the payment is made. It is highly recommended to use merchant_code instead of pay_to_email.

purpose'SETUP_RECURRING_PAYMENT' | 'CHECKOUT'

Purpose of the checkout creation initially

status'EXPIRED'

Current status of the checkout.

valid_untilstring date-time nullable

Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.

Example response

{
  "currency": "EUR",
  "date": "2020-02-29T10:56:56+00:00",
  "transactions": [
    {
      "amount": 10.1,
      "currency": "EUR",
      "id": "6b425463-3e1b-431d-83fa-1e51c2925e99",
      "timestamp": "2020-02-29T10:56:56.876Z",
      "transaction_code": "TEENSK4W2K",
      "auth_code": "053201",
      "internal_id": 1763892018,
      "merchant_code": "MH4H92C7",
      "tip_amount": 3,
      "vat_amount": 6
    }
  ],
  "valid_until": "2020-02-29T10:56:56+00:00"
}

Changes