Проверка статуса платежа

Пример

Запрос

URL

POSThttps://api-merchant.alikassa.com/v1/payment/status📋

Заголовки:

• Content-Type: application/json
• Account: UUID вашего аккаунта (доступен по адресу: Счета проекта)
• Sign: Подпись запроса

Перейдите в Настройки API сертификатов и сгенерируйте «API сертификат на оплаты». Сохраните и распакуйте архив:

• password.txt
• private.pem
• public.pem

Мы сохраняем только public.pem для проверки подписи.

Оберните все POST-данные в JSON (в том же порядке) и подпишите:

$data = json_encode($data);

$privateKey = openssl_pkey_get_private(
    file_get_contents('private.pem'),
    file_get_contents('password.txt')
);

if ($privateKey === false) {
    throw new \Exception('Ошибка сертификата.');
}

openssl_sign($data, $sign, $privateKey);
$sign = base64_encode($sign);

import { readFileSync } from 'fs';
import { createSign } from 'crypto';

const dataStr = JSON.stringify(data);
const privateKeyPem = readFileSync('private.pem', 'utf8');
const passphrase = readFileSync('password.txt', 'utf8').trim();
const signer = createSign('SHA256');
signer.update(dataStr);
signer.end();
const sign = signer.sign({ key: privateKeyPem, passphrase }, 'base64');

import json, base64
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding

data_bytes = json.dumps(data).encode('utf-8')
with open('password.txt','rb') as f:
    password = f.read().strip()
with open('private.pem','rb') as f:
    private_key = serialization.load_pem_private_key(f.read(), password=password)
signature = private_key.sign(data_bytes, padding.PKCS1v15(), hashes.SHA256())
sign = base64.b64encode(signature).decode('utf-8')

import java.nio.file.Files;
import java.nio.file.Paths;
import java.security.Signature;
import java.util.Base64;
import org.bouncycastle.openssl.PEMEncryptedKeyPair;
import org.bouncycastle.openssl.PEMParser;
import org.bouncycastle.openssl.jcajce.JcePEMDecryptorProviderBuilder;
import org.bouncycastle.openssl.jcajce.JcaPEMKeyConverter;

byte[] dataBytes = new ObjectMapper().writeValueAsBytes(data);
char[] pass = Files.readString(Paths.get("password.txt")).toCharArray();
PEMParser parser = new PEMParser(Files.newBufferedReader(Paths.get("private.pem")));
PEMEncryptedKeyPair ckp = (PEMEncryptedKeyPair) parser.readObject();
PrivateKey privateKey = new JcaPEMKeyConverter()
    .getKeyPair(ckp.decryptKeyPair(new JcePEMDecryptorProviderBuilder().build(pass)))
    .getPrivate();
Signature sig = Signature.getInstance("SHA256withRSA");
sig.initSign(privateKey);
sig.update(dataBytes);
String sign = Base64.getEncoder().encodeToString(sig.sign());

import (
    "crypto"
    "crypto/rand"
    "crypto/rsa"
    "crypto/sha256"
    "crypto/x509"
    "encoding/base64"
    "encoding/json"
    "encoding/pem"
    "io/ioutil"
)

dataBytes, _ := json.Marshal(data)
pemBytes, _ := ioutil.ReadFile("private.pem")
passBytes, _ := ioutil.ReadFile("password.txt")
block, _ := pem.Decode(pemBytes)
der, _ := x509.DecryptPEMBlock(block, passBytes)
priv, _ := x509.ParsePKCS1PrivateKey(der)
hash := sha256.Sum256(dataBytes)
sigBytes, _ := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA256, hash[:])
sign := base64.StdEncoding.EncodeToString(sigBytes)

Полученную подпись $sign передайте в заголовке Sign.

---

Обязательные поля

Обязательный параметр

Вы должны передать order_id или id.

Название	Тип	Описание
order_id	string (128)	Ваш ID, указанный при создании
id	string (128)	ID платежа AliKassa

---

Ответ

Название	Описание
order_id	Ваш ID
id	ID платежа AliKassa
url	Ссылка на платеж
payment_status	Статус платежа
card_mask	Маскированный номер карты
amount	Сумма
payment_amount	Фактически оплаченная сумма
hold_amount	Сумма холда
hold_at	Дата снятия холда
account_payment_amount	Сумма, зачисленная на счет
commission_amount	Комиссия
service_code	Код сервиса
account_old_balance	Баланс до транзакции
account_new_balance	Баланс после транзакции
crypto_to_account	Криптовалютный счет назначения
crypto_currency	Криптовалюта
crypto_amount	Сумма в криптовалюте
crypto_commission	Комиссия в криптовалюте
crypto_rate	Курс

Значения статуса платежа:

• wait — в процессе оплаты
• paid — успешно оплачено (финальный статус)
• cancel — отменен (финальный статус)
• fail — ошибка (финальный статус)

Пример успешного ответа (HTTP 200):

{
  "url": "https://pay-merchant.alikassa.com/b05119d2-206b-3d04-8365-293b3008b8b0",
  "payment_status": "paid",
  "id": 100000536,
  "order_id": "6422494",
  "card_mask": "516874******8284",
  "amount": "300",
  "payment_amount": "350",
  "hold_amount": "0",
  "hold_at": null,
  "account_payment_amount": "290",
  "commission_amount": "10",
  "service_code": "payment_card_rub",
  "account_old_balance": "1000",
  "account_new_balance": "1290",
  "crypto_to_account": "1233",
  "crypto_currency": "USDT",
  "crypto_amount": "3.5",
  "crypto_commission": "0.1",
  "crypto_rate": "100"
}

Пример ошибки (HTTP 400):

{
  "message": "The given data was invalid.",
  "errors": {
    ...
  }
}

---

Уведомления

Настройка уведомлений

Если вы передали `