Confirm payment with SMS code

Confirms the payment with the SMS code after Charge mobile balance returned pg_status = need_approve.

Only for your own interface: the client enters the phone number and the SMS code on your page. With the Freedom Pay payment page this method is not needed: see Mobile balance.

If the client did not receive the code, send it again with Resend SMS code.

Responses are not signed: they contain no pg_salt and pg_sig.

Confirmation flow: own interface

Result

`pg_status`	Meaning	Next step
`ok`	The amount is charged from the mobile balance.	—
`process` with `pg_error_code`	The code is wrong, for example `601` «OTP incorrect». The payment is not failed.	Ask the client for the code again and repeat the request, or send a new code with Resend SMS code.
`process` without `pg_error_code`	The mobile operator has not confirmed the charge yet.	Get the result with Get mobile balance payment status.
`error`	The request is rejected or the payment failed.	See «Errors» below.

Errors

The HTTP status is always 200; the error is returned in pg_error_code and pg_error_description.

`pg_error_code`	When	What to do
`94031`	A parameter is missing or invalid, or `pg_payment_id` is not found.	Fix the request.
`9998`	The signature is missing or invalid.	Check the signature: see Merchant API Overview.
`9997`	`pg_merchant_id` is not found.	Check the merchant ID.
`340`	Charge mobile balance was not called for this payment, or the payment is already failed.	Call Charge mobile balance first, or create a new payment.
`9001`	The payment is already paid. `pg_error_description` is empty.	Do not repeat the request: get the result with Get mobile balance payment status.
`1000`	Internal error. The payment is not failed.	Repeat the request later.
Other codes	The mobile operator declined the payment.	See Error codes.

Request example

pg_sig is calculated with the secret key test_secret_key.
Line breaks in the body are added for readability: send the body as one line.

application/xml

Bodyapplication/xml

Examples

ChargedWrong code

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>1234567890</pg_payment_id>
    <pg_status>ok</pg_status>
</response>

Confirm payment with SMS code

Confirmation flow: own interface#

Result#

Errors#

Request example#

Request

Responses

Confirmation flow: own interface

Result

Errors

Request example