Application notification

Services that partner e-shops should create and make public in order to enable Skip Pay to notify these partner e-shops asynchronously of significant changes regarding specific applications and orders. Partner e-shops should create and make available this webhook handlers so that Skip Pay can alert them asynchronously to significant changes affecting specific applications.

When there is a need to inform you of significant changes within a specific application, Skip Pay will use this resource. Specifically in the following cases:

Trigger	Corresponding Application.stateReason	Expected reaction
Application was rejected	REJECTED	You should release the reserved goods and cancel the relevant order.
Application was cancelled	CANCELLED_NOT_PAID	You should release the reserved goods and cancel the relevant order.
Order to dispatch (we commit to finance customer's order)	READY_TO_SHIP	Dispatch the order to the customer
Order dispatched	READY_SHIPPED	None - serves as an acknowledgment (partner should know about this change)
Order delivered	READY_DELIVERED	None - serves as an acknowledgment (partner should know about this change)
Application was paid to the partner	READY_PAID	Financial compensation for the application has been processed - check your bank account

READY_PAID state is set when at least part of the application price was paid to the partner, not necessarily full application price. This also applies to the Application was paid to the partner application notification trigger.

We fill the request with following information:

• Application unique ID
• Application state
• Application substate

IMPORTANT: You should always double check the state of Application on /financing/v1/applications/{applicationId} resource due to security reasons.

By default, the notification is automatically sent again (retried) after 1, 5, 5, 5, and 5 minutes if it is not processed due to an error or unavailability (5 tries in total).

In case of change in changes in application, you will receive notification in JSON format like this:

{
    "id": "11200a0ee1",
    "state": "PROCESSING",
    "stateReason": "PROCESSING_REDIRECT_NEEDED"
}

As a response, we expect to send us confirming message like that:

{
    "statusCode": "200",
    "status": "OK"
}

All notifications will be sent to the URL you entered in the NotificationURL parameter when you have created the application.

Financing type	Supported
DEFERRED_PAYMENT	YES
PAY_IN_THREE	YES