Get application detail

GET /financing/v1/applications/:applicationId

If you need to find out current information about particular application - primarily its state and other details - use /financing/v1/applications/{applicationId} resource where {applicationId} is the application ID you received in the response of /financing/v1/applications after its creation.

Financing type	Supported
`DEFERRED_PAYMENT`	YES
`PAY_IN_THREE`	YES

If the request was successfully processed, you receive HTTP status code 200 and application object.

In other cases, you may receive errors similar to the following ones:

Status code	Code	Message
400	`INVALID_REQUEST`	Request was not well formatted (malformed request syntax, size too large, etc.)
404	`APPLICATION_NOT_FOUND`	The requested resource could not be found
422	`UNPROCESSABLE`	The request was well-formed but was unable to be followed due to semantic errors

Request

Path Parameters

applicationId stringrequired

applicationId

Responses

Actual application data

application/json

Schema
Example (from schema)

Schema

id stringrequired

Unique identifier in Skip Pay

state staterequired

Possible values: [PROCESSING, READY, REJECTED, CANCELLED]

Application state.

stateReason Reason Staterequired

Possible values: [PROCESSING_REDIRECT_NEEDED, PROCESSING_PREAPPROVED, PROCESSING_VALIDATION_IN_PROGRESS, REJECTED, CANCELLED_NOT_PAID, READY_TO_SHIP, READY_SHIPPED, READY_DELIVERED, READY_PAID, CANCELLED_RETURNED]

Describes internal state of application, e.g. when state is PROCESSING - reason why application remains in processing state

customer

object

required

Customer data

titleBefore stringnullable

Possible values: <= 60 characters

Academical degree, in front of the name

titleAfter stringnullable

Possible values: <= 60 characters

Academical degree, behind name

email stringrequired

Possible values: <= 254 characters

E-mail address of customer

addresses

object[]

Addresses. All types are allowed.

Array [

name stringnullable

Possible values: <= 100 characters

Name on address

country stringrequired

Country. (see ISO 3166 alpha-2)

city stringrequired

Possible values: <= 100 characters

City

streetAddress stringrequired

Possible values: <= 100 characters

Street/city part

streetNumber stringnullable

Possible values: <= 100 characters

Street number

zip stringrequired

Possible values: <= 30 characters

Postal code

addressType addressTyperequired

Possible values: [PERMANENT, CONTACT, DELIVERY, BILLING]

Type of the address. Only some of the types are allowed in each context.

]

tin stringnullable

Possible values: <= 20 characters

Tax identification number (ICO)

vatin stringnullable

Possible values: <= 20 characters

VAT identification number

extraData

object

required

transactionsNumber numberrequired

Historical count of customer transactions made in partner's e-shop

cashlessTransactionsNumber number

Historical count of customer cashless transactions made in partner's e-shop

transactionsSum

object

required

Financial amount

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

cashlessTransactionsSum

object

Financial amount

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

latestTransactionDate datenullable

Date of customer's latest (newest) transaction on partner e-shop.

earliestTransactionDate daterequired

Date of customer's earliest (oldest) transaction on partner e-shop.

pageTotalTime numbernullable

Possible values: >= 1

Total time spent on partners website (in seconds)

pageReviewsTime numbernullable

Possible values: >= 1

Total time spent on partners website in review and comments sections (in seconds)

cartItemsRemoved numbernullable

Possible values: >= 1

Total count of removed items form shopping basket during current shopping

itemsViewed numbernullable

Possible values: >= 1

Number of viewed pages with products

tags string[]nullable

Possible values: <= 10 characters

List of custom tags (ie. information, that customer is club member, vip customer, etc.)

firstName stringrequired

Possible values: <= 60 characters

Customer first (given) name. Must be paired with lastName. Required if fullName is empty.

lastName stringrequired

Possible values: <= 60 characters

Customer last (family) name. Must be paired with firstName. Required if fullName is empty.

fullName stringrequired

Possible values: <= 240 characters

Customer full name, including academical degrees and salutation. Required only if firstName or lastName are empty.

phone stringrequired

Possible values: <= 13 characters

Phone number with country code (including leading +).

PrecheckResultResponseSerializer PrecheckResultResponseSerializer

Possible values: [UNKNOWN, FIRST_ORDER, FULL, BLOCKED]

Customer type.

order

object

required

Order information, needed to create an application.

number stringrequired

Possible values: <= 100 characters

Order number (internal for e-shop)

variableSymbols string[]

Variable symbols for pairing. First symbol in array is used for making the payment to your account (if not specified later in Mark order items as sent or Mark order items as delivered) or we expect you make payment on our account with this symbol (if not specified later in Mark order items as returned operation). Strings must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.

totalPrice

object

required

Order total price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

totalVat

object[]

required

Total VAT amounts split by their VAT rates.

Array [

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

]

addresses

object[]

Addresses. Only BILLING and DELIVERY types are allowed.

Array [

name stringnullable

Possible values: <= 100 characters

Name on address

country stringrequired

Country. (see ISO 3166 alpha-2)

city stringrequired

Possible values: <= 100 characters

City

streetAddress stringrequired

Possible values: <= 100 characters

Street/city part

streetNumber stringnullable

Possible values: <= 100 characters

Street number

zip stringrequired

Possible values: <= 30 characters

Postal code

addressType addressTyperequired

Possible values: [PERMANENT, CONTACT, DELIVERY, BILLING]

Type of the address. Only some of the types are allowed in each context.

]

deliveryType deliveryType

Possible values: [DELIVERY_CARRIER, PERSONAL_BRANCH, PERSONAL_PARTNER, ONLINE]

Delivery type, for DELIVERY_CARRIER type can be further specified by deliveryCarrier attribute.

deliveryCarrier

object

oneOf

DeliveryCarrierPredefined
DeliveryCarrierCustom

carrierId carrierIdrequired

Possible values: [AIRWAY, CZ_POST_HAND, CZ_POST_OFFICE, CZ_POST_OTHER, DACHSER, DB_SCHENKER, DEUTSCHE_POST_DHL, DHL, DHL_EXPRESS, DHL_FREIGHT, DPD, DSV, FEDEX, FOFR, GEBRUDER_WEISS, GEIS, GLS, HDS_COMFORT, HDS_STANDARD, IN_TIME, JAPO_TRANSPORT, LIFTAGO, LOCAL_COURIER, MAGYAR_POSTA, MALL_DELIVERY, MALL_DEPOSIT, MESSENGER, POSTA_BEZ_HRANIC, PPL, PPL_PARCEL_CONNECT, RABEN, SAMEDAY, SDS, SLOVAK_PARCEL_SERVICE, SLOVENSKA_POSTA, SPRING_GDS, TNT, TOP_TRANS, UPS, WEDO, WEDO_ULOZENKA, ZASILKOVNA]

carrierCustom carrierCustomrequired

Possible values: <= 250

For carriers not found in the enumeration of carrierId, specify the value as text.

channel channel

Possible values: [ESHOP, BRANCH, FRANCHISE, TELEPHONE, INTERNAL]

Default value: ESHOP

Sales channel, indicates how or where the order is created. (ie. via e-mail, eshop or at a branch)

reservationDate datetimenullable

Date and time until order is reserved.

Until 'reservationDate' Skip Pay will try to notify partner with Application notification about approval or rejection.

After this date and time, e-shop does not guarantee items availability (if application processing is longer, it may endanger order fullfillment).

state Order Staterequired

Possible values: [PROCESSING, SENT, DELIVERED, RETURNED, CANCELLED]

Order state.

deliveryDate datenullablerequired

Date and time of delivery

deliveryTrackingNumber stringnullablerequired

Possible values: <= 64 characters

Delivery tracking number

sentDate datenullablerequired

Date and time of order shipping

documents

object[]

Attached documents (invoices etc.)

Array [

type Document Serializerrequired

Possible values: [INVOICE, PROFORMA_INVOICE, CREDIT_NOTE, OTHER]

Type of the document

file

object

required

filename stringrequired

Possible values: <= 100 characters

File name.

url urlrequired

File URL (URL is accessible only 1 hour from its generation for security reasons)

description stringnullable

File description

extraData

object

variableSymbol stringnullable

Variable symbol of this document (proforma, invoice, ...). This string must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.

]

items

object[]

required

Order items

Array [

code stringrequired

Possible values: <= 200 characters

Internal code for item (internal to e-shop). Used to better identify the item for future changes

ean stringnullable

Possible values: <= 64 characters

EAN code.

name stringrequired

Possible values: <= 255 characters

Item name

type Item Typenullable

Possible values: [PHYSICAL, DISCOUNT, SHIPPING_FEE, SALES_TAX, DIGITAL, GIFT_CARD, STORE_CREDIT, FEE, INSURANCE]

Item type

variant stringnullable

Possible values: <= 250 characters

Item variant

description stringnullable

producer stringnullable

Possible values: <= 250 characters

Producer name

categories string[]nullable

List of item categories

totalPrice

object

required

Order items total price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

totalVat

object

required

Order items VAT including VAT rate.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

productUrl urlnullable

Possible values: <= 200 characters

URL of the item in e-shop

state Order Staterequired

Possible values: [PROCESSING, SENT, DELIVERED, RETURNED, CANCELLED]

Order state.

sentDate datenullablerequired

Date when item was sent. Only when the whole order was NOT sent at once.

deliveryDate datenullablerequired

Date when item was delivered. Only when the whole order was NOT sent at once.

deliveryTrackingNumber stringnullablerequired

Possible values: <= 64 characters

Tracking number for the item. Only when the whole order was NOT sent at once.

image

object

filename stringrequired

Possible values: <= 100 characters

File name.

url urlrequired

File URL.

unitPrice

object

required

Order unit item price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

unitVat

object

required

Financial amount with VAT rate.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

quantity numberrequired

Possible values: >= 1

(positive float/decimal up to 3 decimal places) Item quantity.

]

merchantId stringnullablerequired

Merchant identification

type Financing Typerequired

Possible values: [DEFERRED_PAYMENT, PAY_IN_THREE]

Financing type

agreementTermsAndConditions booleanrequired

Terms and conditions agreement

gatewayRedirectUrl stringrequired

Gateway redirect URL. Redirect user to this URL if state is PROCESSING and stateReason is PROCESSING_REDIRECT_NEEDED.

recurrence

object

id stringrequired

Unique identifier in Skip Pay

state Recurrence Staterequired

Possible values: [APPROVING, READY, CANCELLED, EXPIRED]

Recurrence state

{
  "id": "11200a0ee1",
  "state": "PROCESSING",
  "stateReason": "PROCESSING_REDIRECT_NEEDED",
  "customer": {
    "titleBefore": "Ing.",
    "titleAfter": "CSc.",
    "email": "john.newborn@country.com",
    "addresses": [
      {
        "name": "John Doe",
        "country": "CZ",
        "city": "Prague",
        "streetAddress": "Letenská",
        "streetNumber": "22",
        "zip": "140 00",
        "addressType": "PERMANENT"
      }
    ],
    "tin": "12333321",
    "vatin": "CZ8402154456",
    "extraData": {
      "transactionsNumber": 10,
      "cashlessTransactionsNumber": 5,
      "transactionsSum": {
        "amount": 12590,
        "currency": "CZK"
      },
      "cashlessTransactionsSum": {
        "amount": 12590,
        "currency": "CZK"
      },
      "latestTransactionDate": "2024-05-15",
      "earliestTransactionDate": "2015-10-12",
      "pageTotalTime": 250,
      "pageReviewsTime": 100,
      "cartItemsRemoved": 2,
      "itemsViewed": 10,
      "tags": [
        "string"
      ]
    },
    "firstName": "John",
    "lastName": "Newborn",
    "fullName": "Ing. John Newborn, Csc.",
    "phone": "+420123456789",
    "PrecheckResultResponseSerializer": "UNKNOWN"
  },
  "order": {
    "number": "AA234",
    "variableSymbols": [
      "string"
    ],
    "totalPrice": {
      "amount": 12590,
      "currency": "CZK"
    },
    "totalVat": [
      {
        "amount": 12590,
        "currency": "CZK",
        "vatRate": 15
      }
    ],
    "addresses": [
      {
        "name": "John Doe",
        "country": "CZ",
        "city": "Prague",
        "streetAddress": "Letenská",
        "streetNumber": "22",
        "zip": "140 00",
        "addressType": "PERMANENT"
      }
    ],
    "deliveryType": "DELIVERY_CARRIER",
    "deliveryCarrier": {
      "carrierId": "DPD"
    },
    "channel": "BRANCH",
    "reservationDate": "2017-07-15T00:00:00+02:00",
    "state": "PROCESSING",
    "deliveryDate": "2017-01-17",
    "deliveryTrackingNumber": "EX12221",
    "sentDate": "2017-01-12",
    "documents": [
      {
        "type": "INVOICE",
        "file": {
          "filename": "invoice.pdf",
          "url": "https://www.partner.com/file?id=12345"
        },
        "description": "This is an invoice",
        "extraData": {
          "variableSymbol": "1234567890"
        }
      }
    ],
    "items": [
      {
        "code": "EXC4677-1a",
        "ean": "888462064002",
        "name": "iPhone 6s 32GB SpaceGray",
        "type": "PHYSICAL",
        "variant": "32GB SpaceGray",
        "description": "Mobile phone with 32GB of RAM",
        "producer": "Apple",
        "categories": [
          "string"
        ],
        "totalPrice": {
          "amount": 12590,
          "currency": "CZK"
        },
        "totalVat": {
          "amount": 12590,
          "currency": "CZK",
          "vatRate": 15
        },
        "productUrl": "https://www.example.com",
        "state": "PROCESSING",
        "sentDate": "2017-01-10",
        "deliveryDate": "2017-01-12",
        "deliveryTrackingNumber": "EX21121",
        "image": {
          "filename": "invoice.pdf",
          "url": "https://www.partner.com/file?id=12345"
        },
        "unitPrice": {
          "amount": 12590,
          "currency": "CZK"
        },
        "unitVat": {
          "amount": 12590,
          "currency": "CZK",
          "vatRate": 15
        },
        "quantity": 1
      }
    ],
    "merchantId": "ABCD1234"
  },
  "type": "PAY_IN_THREE",
  "agreementTermsAndConditions": true,
  "gatewayRedirectUrl": "http://myredirectURL.com",
  "recurrence": {
    "id": "abcd1234",
    "state": "APPROVING"
  }
}

Application does not exist

application/json

Schema
Example (from schema)

Schema

errors

object[]

required

Array with errors

Array [

code stringrequired

Unique internal error code

message stringrequired

Human readable error description (non-localized)

severity Severityrequired

Possible values: [ERROR, WARN, INFO]

attribute string

JSON path of request attribute that caused the error (if applicable)

ticketId string

Internal ticket ID, used for error backtracking

]

{
  "errors": [
    {
      "code": "ERR_1000_SOME_ERROR_CODE",
      "message": "Some error/validation message description",
      "severity": "ERROR",
      "attribute": "personalBirthNumber",
      "ticketId": "UAT1:AMS:20160516-091658.450:45e4"
    }
  ]
}

Get application detail

/financing/v1/applications/:applicationId

Request​

Path Parameters

Responses​

Request

Responses