Наш сервер надає JSON 2.0 RPC інтерфейс для обробки платежів у мережі Карбованця та створення адрес для отримання карбованців, котрі відслідковуватимуться нашим шлюзом. Нижче наведена інформація по доступних методах запитів до сервера.

Здійснити JSON PRC запит можна через запит POST наступним чином:

https://karbo.club/api

Get unconfirmed transaction hashes – пошук непідтверджених платежів

getUnconfirmedTransactionHashes() – метод повертає інформацію про поточні непідтверджені транзакції для вказаних адрес.

Транзакція складається з переказів. Переказ це пара "сума-адреса". У транзакції може бути кілька переказів.

Запит:

Примітка: якщо задано параметр addresses, метод getUnconfirmedTransactionHashes() повертає транзакції котрі містять перекази хоча б для одної з вказаних адрес. Цим потрібно користуватись для перевірки наявності непідтвердженої транзакції для вашої адреси.

Відповідь:

Приклад запиту:

{  
   "params":{  
      "addresses":[  
         "KdbDPifEfmQDZAxMxjrkbPPLHtwv1ezGr2GRB3P377ecToxGkrTFTe2EEjAKbhPqA61FPTi14UpkMVMh2pn1et1y8PdDwn4"
      ]
   },
   "jsonrpc":"2.0",
   "id":"test",
   "method":"getUnconfirmedTransactionHashes"
}

Приклад відповіді:

{  
   "jsonrpc":"2.0",
   "id":"test",
   "result":{  
      "transactionHashes":[  
         ...,
         ...,
         ...
      ]
   }
}

Get transactions – пошук транзакцій

getTransactions() – метод повертає масив хешів блоків і транзакцій.

Запит:

Примітка: якщо вказано параметр paymentId, метод getTransactions() повертає транзакції що містять вказаний payment_id (у заданому діапазоні блоків).

Примітка: якщо вказано параметр addresses, метод getTransactions() повертає транзакції що містять перекази для/з принаймні однієї зі вказаних адрес.

Примітка: якщо вказано обидва параметри, метод getTransactions() повертає транзакції, котрі містять вказаний payment_id і перекази з/до як мінімум однієї зі вказаних адрес.

Це використовується для пошуку конкретного платежу для вашого магазину.

Відповідь:

Приклад запиту:

 {  
   "params":{  
      "blockCount":1000,
      "firstBlockIndex":1,
      "addresses":[  
         "KfXkT5VmdqmA7bWqSH37p87hSXBdTpTogN4mGHPARUSJaLse6jbXaVbVkLs3DwcmuD88xfu835Zvh6qBPCUXw6CHK8koDCt",
         "KegWNCZv8CQ5YoUZFLAUpxQhHt9FAo5KhXBEaHGTeaDD1t5ZZsKoEMQ8sgUMcyKbwpFJGaaY73Bwf3bUXVLsgAZa7nCv85k",
         "KiQ5AonXm7saDTsNEi9uJsb5HswnafrsVLn2vWT1PGGTi1KFbJypdqs7xWrdU54ieXcdQtiV1bDAcVZjYjwFg41v9v7x869"
      ],
      paymentId:"somePaymentId"
   },
   "jsonrpc":"2.0",
   "id":"test",
   "method":"getTransactions"
}

Приклад відповіді:

{  
   "jsonrpc":"2.0",
   "id":"test",
   "result":{  
      "items":[  
         {  
            "blockHash":"01bd06ca731914f27e143bbb902ce0bc05bff13d76faa027ea817e68f217488c",
            "transactions":[  
               {  
                  "fee":100000000,
                  "extra":"0127cea59bfadc49aa02ed4a225936671e55607b5241621abca2a5e14405906dbb",
                  "timestamp":1446029698,
                  "blockIndex":1,
                  "state":0,
                  "transactionHash":"06ec210a8359f253f8b2160a0d6040cf89f2a05a553aaa577b7f508ee5d831f9",
                  "amount":70368475742208,
                  "unlockTime":11,
                  "transfers":[  
                     {  
                        "amount":70368475742208,
                        "type":0,
                        "address":"KfXkT5VmdqmA7bWqSH37p87hSXBdTpTogN4mGHPARUSJaLse6jbXaVbVkLs3DwcmuD88xfu835Zvh6qBPCUXw6CHK8koDCt"
                     }
                  ],
                  "paymentId":"",
                  "isBase":True
               }
            ]
         },
         {  
            "blockHash":"28aa7d32f4274f6387969d7671bd4db98fd871bf0dd510a1df5e2ef4b1d41a35",
            "transactions":[  
               {  
                  "fee":100000000,
                  "extra":"01a8e6e408282b2ddf343e20d5e9aab283723ba10ab7ab7b3131f6981b02a84431",
                  "timestamp":1446029698,
                  "blockIndex":2,
                  "state":0,
                  "transactionHash":"922d00d2e6eaed63f62d8e3b968cb08b6ea5c555fe0e6af948ab06efe6eb213a",
                  "amount":70368207307776,
                  "unlockTime":12,
                  "transfers":[  
                     {  
                        "amount":70368207307776,
                        "type":0,
                        "address":"KfXkT5VmdqmA7bWqSH37p87hSXBdTpTogN4mGHPARUSJaLse6jbXaVbVkLs3DwcmuD88xfu835Zvh6qBPCUXw6CHK8koDCt"
                     }
                  ],
                  "paymentId":"",
                  "isBase":True
               }
            ]
         }
      ]
   }
}

Get transaction – інформація про транзакцію

getTransaction() – метод повертає інформацію про певну транзакцію.

Запит:

Приклад запиту:

{  
   "params":{  
      "transactionHash":"92423b0857d36bd172b3f2effbd47ea477bfe0618a50c29d475542c6d5d1b835"
   },
   "jsonrpc":"2.0",
   "id":"test",
   "method":"getTransaction"
}

Приклад відповіді:

{  
   "jsonrpc":"2.0",
   "id":"test",
   "result":{  
      "transaction":{  
         "fee":1000000,
         "extra":"0130b4472974f2deb9fae7d8fd6602b26396379f3fa05cca2430e10e9e60179f42",
         "timestamp":0,
         "blockIndex":4294967295,
         "state":0,
         "transactionHash":"92423b0857d36bd172b3f2effbd47ea477bfe0618a50c29d475542c6d5d1b835",
         "amount":-1703701,
         "unlockTime":0,
         "transfers":[  
            {  
               "amount":123456,
               "type":0,
               "address":"KiQxu9U3F7vdGggu4NQ3CKDhk59vMQyMaFbLtu7TU4TdUkNtuJufqpo67r2e5j5p44SBsBBygaRdmeB4gwH9CF1C3zufGWd"
            },
            {  
               "amount":234567,
               "type":0,
               "address":"KccShmn49D4JZED1g4CM98RpszuMbbDEaYNVpCWjUkDuWPVpo8EEUHaReKeHBmpoNdTENs841QUBRNitFHD7W29oDVfV9ze"
            },
            {  
               "amount":345678,
               "type":0,
               "address":"KfCPBzzR28edvZqLv6t8XVY98jeK6YEjS3birBPTHjY1hXSFM5k5pjUNSur6UhbP8EaqhZ69PVJF991KqCtYFox7NUSvcjw"
            }
         ],
         "paymentId":"",
         "isBase":False
      }
   }
}