Skip to main content

Providing Status To The Callback URL

Delivery of the status to the Callback URL is possible only if the integrator has called the order creation command!

The Keepz system can provide the final status to the integrator's system. For this, the integrator needs to provide the Keepz representative with the URL in advance, where they will receive the final status. The URL should receive a request of type POST, Content-Type should be application/json, and should contain the following parameters:

  • encryptedData (String) - Request details encrypted with Keepz key. The encoded value must contain the following parameters:
    • systemId (Long) - Unique identifier of the order in the Keepz system.
    • amount (Double) - Amount of the requested funds (in GEL).
    • receiverId (UUID) - Identifier of the recipient of the money in the Keepz system (provided to the integrator by a Keepz representative).
    • receiverType (String) - The type of receiver of the money in the Keepz system.
    • integratorId (UUID) - Unique identifier of the integrator in the Keepz system (provided to the integrator by the Keepz representative).
    • integratorOrderId (UUID) - Unique identifier of the order in the integrator system.
    • status (String) - The status of the order in the Keepz system.

Example:

{
    "encryptedData": "string"
}

{
    "systemId": 1,
    "amount": 1.0,
    "receiverId": "0349ce8d-8061-4867-94a9-b9de0fb3fec6",
    "receiverType": "BRANCH",
    "integratorId": "ce8cc897-6963-4116-ac81-91323d172012",
    "integratorOrderId": "8ab2df0b-c749-4a68-bf3c-1179d17b83a4",
    "status": "EXPIRED"
}