Payment Confirmation

As a payment is processed, we notify the store platform about the payment status. Requests are sequentially sent to the URL of your handler (set in the project settings). First, a CHECK request is made, followed by a PAY request after a successful response and funds are deducted from the client. In case of any error during the payment process, an ERROR request is made.

CHECK - Once the payment is created, the Pay4Bit system returns its key details, such as paymentId and digital signatures.

PAY - Notification of successful deduction; you need to provide the service to the subscriber. In case of any error at this stage (e.g., database is unavailable), the payment receives a “not completed” status. Once the issue is resolved, you can retry processing the payment via dashboard.

ERROR - Payment error at any stage. If the error is caused by an empty/incorrect server response, the request will not be sent. Note that this status is not final, and there may be situations where a PAY request follows an ERROR request.




method – one of the methods.
projectId – Your store ID in the Pay4Bit system.
localpayId – Pay4Bit Payment ID.
account – Subscriber identifier in the partner’s system.
sum – Paid amount.
amount – Paid amount (formatted to two decimal places).
currency – Currency in which the payment was made.
paymentType – The system in which the payment was made.
revenue – Revenue amount (In EUR).
sign – Digital signature. It is formed as an md5 hash of the concatenated values of payment id, account, sum, and merchant secret key.
check_sign – Digital signature. It is formed as a sha256 hash of the concatenated values of desc, account, amount, and merchant secret key.

Successful Response

The response should be sent in JSON format


message – Text status of the request execution.

Error Response

The response should be sent in JSON format


message – Text status of the request execution.