Общие методы

{
  "client_ip": "10.20.30.40",
  "pin_code": "987656"
}

<?xml version="1.0" encoding="utf-8"?>
<Request>
  <Header>
    <Authentication>
      <Login>MerchantLogin</Login>
      <NowUtc>20210329200008</NowUtc>
      <Signature>7059c4583a90328ec9f8a0e86495848521ec90005d1075419f0c5f38b0325f48</Signature>
    </Authentication>
    <RequestAttempt>0</RequestAttempt>
  </Header>
  <AuthorizeInvoiceRequest>
    <ProjectID>1234</ProjectID>
    <ClientIP>10.20.30.40</ClientIP>
    <InvoiceInfo>
      <InvoiceID>1624505c-0031-00cf-7d54-4cf1ce08cb30</InvoiceID>
      <MerchantOrderID>order_123</MerchantOrderID>
    </InvoiceInfo>
    <AuthorizeInfo>
      <PinCode>987656</PinCode>
    </AuthorizeInfo>
  </AuthorizeInvoiceRequest>
</Request>

{
  "success": true,
  "data": {
    "invoice_id": "1624505c-0031-00cf-7d54-4cf1ce08cb30",
    "status": "Authorize"
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Response>
  <ResultCode>0</ResultCode>
  <ResultDescription>OK</ResultDescription>
  <AuthorizeInvoiceResponse/>
</Response>

{
  "client_ip": "10.20.30.40"
}

<?xml version="1.0" encoding="utf-8"?>
<Request>
  <Header>
    <Authentication>
      <Login>MerchantLogin</Login>
      <NowUtc>20210329200008</NowUtc>
      <Signature>7059c4583a90328ec9f8a0e86495848521ec90005d1075419f0c5f38b0325f48</Signature>
    </Authentication>
    <RequestAttempt>0</RequestAttempt>
  </Header>
  <CancelInvoiceRequest>
    <ProjectID>1234</ProjectID>
    <ClientIP>10.20.30.40</ClientIP>
    <InvoiceInfo>
      <InvoiceID>1624505c-0031-00cf-7d54-4cf1ce08cb30</InvoiceID>
    </InvoiceInfo>
  </CancelInvoiceRequest>
</Request>

{
  "success": true,
  "data": {
    "invoice_id": "1624505c-0031-00cf-7d54-4cf1ce08cb30",
    "status": "Cancelled"
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Response>
  <ResultCode>0</ResultCode>
  <ResultDescription>OK</ResultDescription>
</Response>

<?xml version="1.0" encoding="utf-8"?>
<Request>
  <Header>
    <Authentication>
      <Login>MerchantLogin</Login>
      <NowUtc>20210329200008</NowUtc>
      <Signature>7059c4583a90328ec9f8a0e86495848521ec90005d1075419f0c5f38b0325f48</Signature>
    </Authentication>
    <RequestAttempt>0</RequestAttempt>
  </Header>
  <GetInvoiceRequest>
    <ProjectID>1234</ProjectID>
    <InvoiceInfo>
      <InvoiceID>1624505c-0031-00cf-7d54-4cf1ce08cb30</InvoiceID>
    </InvoiceInfo>
  </GetInvoiceRequest>
</Request>

{
  "success": true,
  "data": {
    "invoice_id": "1624505c-0031-00cf-7d54-4cf1ce08cb30",
    "status": "Processed",
    "payment_status": "PAID",
    "authorization": {
      "type": "BY_CONTRACT",
      "is_authorized": true
    },
    "price": {
      "amount": "25.00",
      "currency": "RUB",
      "vat_included": true
    },
    "merchant_order_id": "order_123",
    "created_at": "2025-03-29T20:00:10Z",
    "expires_at": "2025-03-29T22:00:10Z",
    "billing_channel": "CPA",
    "customer": {
      "type": "mobile_phone",
      "msisdn": "79600000000",
      "country": "RU",
      "network":  { "id": 3,  "name": "Beeline" },
      "operator": { "id": 42, "name": "Beeline" }
    },
    "transactions": [
      {
        "transaction_id": "B4DA05E2-1D77-40C9-85AC-0BB3835DE8B5",
        "part_number": 1,
        "sequence_number": 1,
        "status": "FAILED",
        "result_code": 210,
        "result_description": "PAYMENT_CHANNEL_NOT_ENOUGH_MONEY",
        "paid_at": "2025-03-29T20:00:10Z",
        "price":          { "amount": "25.00", "currency": "RUB", "vat_included": true },
        "partner_profit": { "amount": "0.00",  "currency": "RUB", "vat_included": true },
        "total_paid":     { "amount": "0.00",  "currency": "RUB", "vat_included": true },
        "total_remaining":{ "amount": "25.00", "currency": "RUB", "vat_included": true },
        "billing_channel": "CPA",
        "service_number": "1234"
      }
    ]
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Response>
  <GetInvoiceResponse>
    <InvoiceInfo>
      <MerchantOrderID>order_123</MerchantOrderID>
      <CustomerPrice amount='25' currency='RUB' includingVAT='true' />
      <CreatedTimeUtc>2021-03-29T20:00:10</CreatedTimeUtc>
      <ExpirationTimeUtc>2021-03-29T22:00:10</ExpirationTimeUtc>
      <InvoiceStatus>Processed</InvoiceStatus>
      <PaymentStatus>PAID</PaymentStatus>
      <AuthorizationType>BY_CONTRACT</AuthorizationType>
      <IsAuthorized>true</IsAuthorized>
      <InvoiceID>1624505c-0031-00cf-7d54-4cf1ce08cb30</InvoiceID>
    </InvoiceInfo>
    <ProjectID>1234</ProjectID>
    <MobilePhoneCustomer>
      <MSISDN>79600000000</MSISDN>
      <Country>ru</Country>
      <NetworkID>3</NetworkID>
      <OperatorID>42</OperatorID>
    </MobilePhoneCustomer>
    <PaymentTransactionsInfo>
      <PaymentTransaction>
        <TransactionID>B4DA05E2-1D77-40C9-85AC-0BB3835DE8B5</TransactionID>
        <PaymentPartNumber>1</PaymentPartNumber>
        <PaymentSequenceNumber>1</PaymentSequenceNumber>
        <PaymentStatus>FAILED</PaymentStatus>
        <PaymentResultCode>210</PaymentResultCode>
        <PaymentResultDescription>PAYMENT_CHANNEL_NOT_ENOUGH_MONEY</PaymentResultDescription>
        <PaymentTimeUtc>2021-03-29T20:00:10</PaymentTimeUtc>
        <CustomerPrice amount='25' currency='RUB' includingVAT='true' />
        <PartnerProfit amount='0' currency='RUB' includingVAT='true' />
        <CustomerPriceTotalPaid amount='0' currency='RUB' includingVAT='true' />
        <CustomerPriceTotalToPay amount='25' currency='RUB' includingVAT='true' />
        <BillingInfo>
          <BillingChannel>CPA</BillingChannel>
          <BillingDetails d6p1:type="MobileBilling" xmlns:d6p1="http://www.w3.org/2001/XMLSchema-instance">
            <ServiceNumber>1234</ServiceNumber>
          </BillingDetails>
        </BillingInfo>
      </PaymentTransaction>
    </PaymentTransactionsInfo>
    <IsContentRequired>false</IsContentRequired>
  </GetInvoiceResponse>
  <ResultCode>0</ResultCode>
  <ResultDescription>OK</ResultDescription>
</Response>

INVOICE_ID=1624505c-0031-00cf-7d54-4cf1ce08cb30
 
curl -sS "$BASE/api/v3/projects/$PROJECT_ID/invoices/$INVOICE_ID" \
  -H "X-Login: $LOGIN" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature-Version: 3" \
  -H "X-Signature: $SIG" | jq '.data.payment_status'

<?php
$invoiceId = '1624505c-0031-00cf-7d54-4cf1ce08cb30';
 
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL        => $base . '/api/v3/projects/' . $projectId . '/invoices/' . $invoiceId,
    CURLOPT_HTTPHEADER => [
        'X-Login: ' . $login,
        'X-Timestamp: ' . $ts,
        'X-Signature-Version: 3',
        'X-Signature: ' . $sig,
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$invoice = json_decode(curl_exec($ch), true)['data'];
curl_close($ch);
 
echo $invoice['payment_status'];

invoice_id = "1624505c-0031-00cf-7d54-4cf1ce08cb30"
 
response = requests.get(
    f"{BASE}/api/v3/projects/{PROJECT_ID}/invoices/{invoice_id}",
    headers={
        "X-Login": LOGIN,
        "X-Timestamp": ts,
        "X-Signature-Version": "3",
        "X-Signature": sig,
    },
    timeout=30,
)
print(response.json()["data"]["payment_status"])

{
  "client_ip": "10.20.30.40"
}

<?xml version="1.0" encoding="utf-8"?>
<Request>
  <Header>
    <Authentication>
      <Login>MerchantLogin</Login>
      <NowUtc>20210329200008</NowUtc>
      <Signature>7059c4583a90328ec9f8a0e86495848521ec90005d1075419f0c5f38b0325f48</Signature>
    </Authentication>
    <RequestAttempt>0</RequestAttempt>
  </Header>
  <RefundInvoiceRequest>
    <ProjectID>1234</ProjectID>
    <ClientIP>10.20.30.40</ClientIP>
    <InvoiceInfo>
      <InvoiceID>1624505c-0031-00cf-7d54-4cf1ce08cb30</InvoiceID>
    </InvoiceInfo>
  </RefundInvoiceRequest>
</Request>

{
  "success": true,
  "data": {
    "invoice_id": "1624505c-0031-00cf-7d54-4cf1ce08cb30",
    "refund_status": "processing"
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Response>
  <ResultCode>0</ResultCode>
  <ResultDescription>OK</ResultDescription>
</Response>