Sign in
Transactions

Retrieve a transaction

Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and one of following parameters is required:

  • id
  • internal_id
  • transaction_code
  • foreign_transaction_id
  • client_transaction_id
get/v2.1/merchants/{merchant_code}/transactions

Path parameters

merchant_codestring required
Example:MC0X0ABC

Query parameters

idstring

Retrieves the transaction resource with the specified transaction ID (the id parameter in the transaction resource).

internal_idstring

Retrieves the transaction resource with the specified internal transaction ID (the internal_id parameter in the transaction resource).

transaction_codestring

Retrieves the transaction resource with the specified transaction code.

Response

OK

amountnumber float

Total amount of the transaction.

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.

idstring

Unique ID of the transaction.

installments_countinteger

Current number of the installment for deferred payments.

payment_type'ECOM' | 'RECURRING' | 'BOLETO'

Payment type used for the transaction.

status'SUCCESSFUL' | 'CANCELLED' | 'FAILED' | 'PENDING'

Current status of the transaction.

timestampstring date-time

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

transaction_codestring

Transaction code returned by the acquirer/processing entity after processing the transaction.

auth_codestring

Authorization code for the transaction sent by the payment card issuer or bank. Applicable only to card payments.

entry_mode'CUSTOMER_ENTRY' | 'BOLETO'

Entry mode of the payment details.

internal_idinteger

Internal unique ID of the transaction on the SumUp platform.

merchant_codestring

Unique code of the registered merchant to whom the payment is made.

tip_amountnumber float

Amount of the tip (out of the total transaction amount).

vat_amountnumber float

Amount of the applicable VAT (out of the total transaction amount).

payout_plan'SINGLE_PAYMENT' | 'TRUE_INSTALLMENT' | 'ACCELERATED_INSTALLMENT'

Payout plan of the registered user at the time when the transaction was made.

payouts_receivedinteger

Number of payouts that are made to the registered user specified in the user property.

payouts_totalinteger

Total number of payouts to the registered user specified in the user property.

product_summarystring

Short description of the payment. The value is taken from the description property of the related checkout resource.

horizontal_accuracynumber float

Indication of the precision of the geographical position received from the payment terminal.

latnumber float

Latitude value from the coordinates of the payment location (as received from the payment terminal reader).

local_timestring date-time

Local date and time of the creation of the transaction.

lonnumber float

Longitude value from the coordinates of the payment location (as received from the payment terminal reader).

payout_type'BANK_ACCOUNT' | 'BALANCE' | 'PREPAID_CARD'

Payout type for the transaction.

simple_payment_type'MOTO' | 'CASH' | 'CC_SIGNATURE' | 'ELV' | 'CC_CUSTOMER_ENTERED' | 'MANUAL_ENTRY' | 'EMV'

Simple name of the payment type.

simple_status'SUCCESSFUL' | 'PAID_OUT' | 'CANCEL_FAILED' | 'CANCELLED' | 'CHARGEBACK' | 'FAILED' | 'REFUND_FAILED' | 'REFUNDED' | 'NON_COLLECTION'

Status generated from the processing status and the latest transaction state.

tax_enabledboolean

Indicates whether tax deduction is enabled for the transaction.

usernamestring email

Email address of the registered user (merchant) to whom the payment is made.

verification_method'none' | 'signature' | 'offline pin' | 'online pin' | 'offline pin + signature' | 'confirmation code verified'

Verification method used for the transaction.

Example response

{
  "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,
  "card": {
    "last_4_digits": "3456"
  }
}

Changes