Public
Payment status
Receiving status of the payment

Forming a request to API for self-integration:
Example of using SDK:
#!/bin/bash
PUBLIC_KEY='your_public_key'
PRIVATE_KEY='your_private_key'
API_URL='https://www.liqpay.ua/api/request'
JSON="{ 
	\"action\" : \"status\",
	\"version\" : 3,
	\"public_key\" : \"${PUBLIC_KEY}\", 
	\"order_id\" : \"order_id_1\"
}"
# DATA is base64_encode result from JSON string
DATA=$(echo -n ${JSON} | base64)
# SIGNATURE is base64 encode result from sha1 binary hash from concatenate string ${PRIVATE_KEY}${DATA}${PRIVATE_KEY}
SIGNATURE=$(echo -n "${PRIVATE_KEY}${DATA}${PRIVATE_KEY}" | openssl dgst -binary -sha1 | base64)
# REQ is json response from liqpay
REQ=$(curl --silent -XPOST ${API_URL} --data-urlencode data="${DATA}" --data-urlencode signature="${SIGNATURE}")
echo "Result: ${REQ}"
$liqpay = new LiqPay($public_key, $private_key);
$res = $liqpay->api("request", array(
'action'        => 'status',
'version'       => '3',
'order_id'      => 'order_id_1'
));
HashMap<String, String> params = new HashMap<String, String>();
params.put("action", "status");
params.put("version", "3");
params.put("order_id", "order_id_1");

LiqPay liqpay = new LiqPay(PUBLIC_KEY, PRIVATE_KEY);
HashMap<String, Object> res = liqpay.api("request", params);		
System.out.println(res.get("status"));
from liqpay import LiqPay

liqpay = LiqPay(public_key, private_key)
res = liqpay.api("request", {
"action"        : "status",
"version"       : "3",
"order_id"      : "order_id_1"
})
liqpay = Liqpay::Liqpay.new(
:public_key  => 'public_key',
:private_key => 'private_key'
)
res = liqpay.api("request", {
:action        => "status",
:version       => "3",
:order_id      => "order_id_1"
})
LiqPay = liqpay:init(PublicKey, PrivateKey),
Res = liqpay:api("request", [
{<<"action">>, <<"status">>},
{<<"version">>, <<"3">>},
{<<"order_id">>, <<"order_id_1">>}
], LiqPay)
var LiqPay = require('liqpay');
var liqpay = new LiqPay(public_key, private_key);
liqpay.api("request", {
"action"   : "status",
"version"  : "3",
"order_id" : "order_id_1"
}, function( json ){
console.log( json.status );
});
my $liqpay = Liqpay->new($public_key,$private_key);
my $res = $liqpay->api("request",
{
'action'        => 'status',
'version'       => '3',
'order_id'      => 'order_id_1'
}
);
Init("my_public_key", "my_private_key")
Api("request", map[string]interface{}{
    "action": "status",
    "version": 3,
    "public_key": PublicKey,
    "order_id": "order_id_1",
})
Options for generating data:
Main
Parameter Required Type Description
version Required Number Version API. Current value - 3
public_key Required String Public key - the store identifier. You can get the key in the store settings
action Required String status
order_id Required String Unique purchase ID in your shop. Maximum length is 255 symbols.
Example response:
{
  "action": "pay",
  "payment_id": 165629,
  "status": "success",
  "version": 3,
  "type": "buy",
  "paytype": "card",
  "public_key": "i000000000",
  "acq_id": 414963,
  "order_id": "98R1U1OV1485849059893399",
  "liqpay_order_id": "NYMK3AE61501685438251925",
  "description": "test",
  "sender_phone": "380950000001",
  "sender_card_mask2": "473118*97",
  "sender_card_bank": "pb",
  "sender_card_type": "visa",
  "sender_card_country": 804,
  "ip": "8.8.8.8",
  "card_token": "2DFBFE626B7341611450DE81E971E948D6F260",
  "info": "My information",
  "amount": 0.02,
  "currency": "UAH",
  "sender_commission": 0.0,
  "receiver_commission": 0.0,
  "agent_commission": 0.0,
  "amount_debit": 0.02,
  "amount_credit": 0.02,
  "commission_debit": 0.0,
  "commission_credit": 0.0,
  "currency_debit": "UAH",
  "currency_credit": "UAH",
  "sender_bonus": 0.0,
  "amount_bonus": 0.0,
  "bonus_type": "bonusplus",
  "bonus_procent": 7.0,
  "authcode_debit": "108527",
  "authcode_credit": "703006",
  "rrn_debit": "000664267598",
  "rrn_credit": "000664267607",
  "mpi_eci": "7",
  "is_3ds": false,
  "create_date": 1501757716373,
  "end_date": 1501757729972,
  "moment_part": true,
  "transaction_id": 165629
}
Response parameters
Parameter Type Description
acq_id Number Acquirer ID
action String Transaction type. Possible values: pay - payment, hold - amount of hold on sender's account, paysplit - splitting payments, subscribe - creation of a regular payment, paydonate - donation, auth - card preauth, regular - regular payment
agent_commission Number Agent comission in payment currency
amount Number Payment amount
amount_bonus Number Payer bonus amount in payment currency debit
amount_credit Number Payment amount for credit in currency of currency_credit
amount_debit Number Payment amount for debit in currency of currency_debit
authcode_credit String Authorization code for transaction of credit
authcode_debit String Authorization code for transaction of debit
bonus_procent Number Discount rate in percent
bonus_type String Bonus type, possible values ​​of bonusplus, discount_club, personal, promo
card_token String Sender's card token
commission_credit Number Commission from the receiver in currency_credit
commission_debit Number Commission from the sender in currency_debit
create_date String Date of payment creation
currency String Payment currency
currency_credit String Transaction currency of credit
currency_debit String Transaction currency of debit
description String Payment description
end_date String Date of payment edition/end
info String Additional payment information
ip String sender's IP address
is_3ds Boolean Possible values:
true - transaction passed with 3DS,
false - transaction passed without 3DS
liqpay_order_id String Payment order_id in LiqPay system
moment_part String Payment indication in parts
mpi_eci Number Possible values: 5 - the transaction passed with 3DS (issuer and acquirer support 3d Secure technology), 6 - the issuer of the payer card does not support 3d Secure technology, 7 - the operation passed without 3d Secure
order_id String Order_id payment
payment_id Number Payment id in LiqPay system
paytype String Methods of payment. Possible values card - card payment, liqpay - with liqpay account, privat24 - with privat24 account, masterpass - with masterpass account, moment_part - installments, cash - cash, invoice - to email, qr - qr code scanning.
public_key String Shop public key
receiver_commission Number Receiver comission in payment currency
rrn_credit String Unique transaction ID in authorization and settlement system of issuer bank Retrieval Reference number
rrn_debit String Unique transaction ID in authorization and settlement system of issuer bank Retrieval Reference number
sender_bonus Number Sender's bonus in the payment currency
sender_card_bank String Sender's card bank
sender_card_country String Sender's card country. Digital ISO 3166-1 code
sender_card_mask2 String Sender's card
sender_card_type String Sender's card type MC/Visa
sender_commission Number Commission from the sender in the payment currency
sender_phone String Sender's phone number
status String Payment status.
Available values:
Final payment statuses
error Failed payment. Data is incorrect
failure Failed payment
reversed Payment refunded
subscribed Subscribed successfully framed
success Successful payment
unsubscribed Subscribed successfully deactivated
Statuses that required payment confirmation
3ds_verify 3DS verification is required.
To finish the payment you will require a 3ds_verify
captcha_verify Waiting for customer to confirm with captcha
cvv_verify Sender's card CVV is required.
To finish the payment you will require a cvv_verify
ivr_verify Waiting for customer to confirm with IVR
otp_verify OTP confirmation is required. OTP is sent to a customer phone number.
To finish the payment it is required otp_verify
password_verify Waiting for customer to confirm with Privat24
phone_verify Waiting for customer to enter a phone number.
To finish the payment you will require a phone_verify
pin_verify Waiting for customer to confirm with PIN-code
receiver_verify Receiver additional data is required.
To finish the payment you will require a receiver_verify
sender_verify Sender's additional data is required.
To finish the payment you will require a sender_verify
senderapp_verify Waiting for customer to confirm with Privat24
wait_qr Waiting for customer to scan QR-code
wait_sender Waiting for customer to confirm in mob app Privat24/SENDER
p24_verify Waiting for payment finish in Privat24
mp_verify Waiting for payment finish in MasterPass wallet
Other payment statuses
cash_wait Waiting for payment in kiosk
hold_wait Amount was successfully blocked on the sender's account
invoice_wait Invoice is created successfully, waiting for a payment
prepared Payment is created, waiting for customer to finish it
processing Payment is processing
wait_accept Money are withdrawn from client but the store is still not verified. If the store is not activated for 90 days, payment will be automatically cancelled
wait_card Recipient didn't set the compensation method
wait_compensation Payment is successful, it will be transferred in daily settlement
wait_lc Protected payment. Charging is successful, waiting for receipt of goods confirmation
wait_reserve Funds are reserved to make a refund according to a refund request
wait_secure Payment is verified
try_again Payment unsuccessful. Client can try again
transaction_id Number Id transactions in the LiqPay system
type String Payment type
version Number Version API. Present value - 3