Payment System Callback

The method is designed to notify the project system about the payment status.

Backoff Policy To increase the reliability of receiving a response, Backoff policies are applied when making requests:

• ntervals between retry attempts: 500 milliseconds

• Time jitter between retries: 0.5 seconds

• Maximum interval between retries: 60 seconds

• Total retry duration: 10 minutes

After completing the payment, the payment system sends a request to the partner project to notify the payment status. The request is made to the URL specified in the callback_url field during the payment process.

If an HTTP status other than 200 is received, the BackOff policies will be applied.

Sending the callback

POSThttps://merchant-website/result

Headers

Name	Value
Content-Type	application/json
X-Signature	Authorization hash

Body

Name	Type	Description
agent*	String	Showcase code in Tarlan system
project*	String	Project Code assigned by Tarlan
service_code*	String	Service ID on the showcase side
external_id*	String	Payment ID on the showcase side

Response

Name	Type	Description
status_code	String	Transaction status code
status_message	String	Description of transaction status
username	String	User ID
amount	Float	Amount credited
datetime	String	Time of payment initiation in the storefront system. ISO 8601 Current Timestamp format
project	String	Project Code assigned by Tarlan
fail_reason	Object	Field Containing the Failure Reason
-code	Int	Rejection Reason Code
-message	String	Description of the Operation Rejection Reason
service_code	String	Service ID on the showcase side
external_id	String	Payment ID on the showcase side
additional_data	Object	Additional information returned depending on the service (Depending on the service, this field may vary)

{
    "project": "Testing",
    "service_code": "70958",
    "external_id": "proident",
    "status_code": "4",
    "status_message": "Transaction was failed",
    "amount": 100.82,
    "datetime": "fugiat sed",
    "username": "enim culpa eiusmod laborum",
    "fail_reason": {
        "code": 6132012,
        "message": "nulla Ut eu dolore"
    }
    "additional_data": {}
}