Payment gateway API АО «Банк ЦентрКредит» предназначен Агентам имеющим разветвленную сеть терминалов для приема оплаты за услуги юридических лиц зарегистрированных в информационной системой Банка
production
development
https://api.bcc.kz:10443/bcc/production
Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
production
https://api.bcc.kz/bcc/production
Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
development
https://api-test.bcc.kz/bcc/production
Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
Пути
/{agent}/services
get /{agent}/services
Получение данных об услугах
Получение спецификации услуг доступных Агенту
Операция по получению актуальной спецификации параметров услуги и списка услуг доступных Агенту на момент вызова
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
exclcat
Опционально в query
string
Параметр форматирования вывода перечня услуг доступных агенту в виде списка или иерархичной структуры основанной на категориях и субкатегориях услуг.
Accept
Опционально в header
string
application/json
200
OK
500
Internal Server Error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services',
qs: { exclcat: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services?exclcat=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/services
{
"categories": [
{
"code": "education",
"name": "Обучение",
"categories": {
"circular_reference": "#/definitions/category"
},
"services": [
{
"id": "2",
"code": "uib",
"name": "UIB",
"note": "Оплата за обучение",
"chktype": "getContractByIin",
"params": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "9.71",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"code": "agreementПопробуйте выполнить эту операцию
/{agent}/services/{srvId}/checks
get /{agent}/services/{srvId}/checks
Получение данных об услугах
Проверка доступных значений для параметров услуги
Операция по онлайн-проверке и получению персонализированых парамтеров для платежа
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
srvId
Required in path
string
Идентификатор типа услуги
_any
Опционально в query
string
Абстрактный параметр. Необходимо передавать каждый параметр услуги (полученный в списке услуг) как отдельный параметр запроса.
Accept
Опционально в header
string
application/json
200
OK
500
Internal Server Error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks',
qs: { _any: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/checks?_any=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/services/{srvId}/checks
[
[
{
"code": "ajerisew",
"prmType": "hocicaslapmun",
"value": "19.06",
"valueMask": "26.91",
"valueList": "63.08"
}
]
]Попробуйте выполнить эту операцию
/{agent}/services/{srvId}/fees
get /{agent}/services/{srvId}/fees
Получение данных об услугах
Расчёт комиссии Банка
Операция по расчету комиссии которую Агент должен взять с Клиента
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
srvId
Required in path
string
Идентификатор типа услуги
amount
Опционально в query
number
Сумма платежа
currency
Опционально в query
string
Валюта платежа согласно стандарта ISO 4217 (KZT,USD,EUR)
_any
Опционально в query
string
Абстрактный параметр. Наименование параметров и их количество определяется согласно описания услуги в сервисе /services.
Accept
Опционально в header
string
application/json
200
Успешное завершение
500
500 Internal Server Error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees',
qs:
{ amount: 'REPLACE_THIS_VALUE',
currency: 'REPLACE_THIS_VALUE',
_any: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/services/REPLACE_SRVID/fees?amount=REPLACE_THIS_VALUE¤cy=REPLACE_THIS_VALUE&_any=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/services/{srvId}/fees
{
"amount": "59449356058624",
"currency": "ALL"
}Попробуйте выполнить эту операцию
/{agent}/transactions
get /{agent}/transactions
Транзакции
Получение списка транзакций
Операция получения списка транзакций (отчёт по транзакциям) введеных в информационную систему Банка а также их статуса
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
dtFrom
Required in query
string / date-time
Дата/время начала. Формат даты dd.mm.yyyyThh24:mi:ss
dtTo
Required in query
string / date-time
Дата/время завершения. Формат даты dd.mm.yyyyThh24:mi:ss
srvId
Опционально в query
integer
Фильтр по идентификатору типа услуги
status
Опционально в query
string
Фильтр по статусу
Accept
Опционально в header
string
application/json
200
OK
500
Internal Server Error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions',
qs:
{ dtFrom: 'REPLACE_THIS_VALUE',
dtTo: 'REPLACE_THIS_VALUE',
srvId: 'REPLACE_THIS_VALUE',
status: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions?dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE&srvId=REPLACE_THIS_VALUE&status=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions
[
{
"id": 52772481,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "gehijvilnuzo",
"statusName": "Kevin Vasquez",
"createDate": "3/21/2029",
"finishDate": "4/29/2123",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "46.9",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "buvpeffuh"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}
]Попробуйте выполнить эту операцию
post /{agent}/transactions
Транзакции
Создание транзакции в информационной системе Банка
Операция по созданию транзакции в информационной системе Банка. Описание с примерами запросов для услуг доступно на https://readme.readme.io/discuss/593720ded5e183000f565bf3
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
body
Required in body
object
Заполненное тело платежа
x-jws-signature
Required in header
string
JSON сообщение с ЭЦП и сертификатом в формате Base64. Дополнительная информация инструкции по работе с ЭЦП, а также в RFC 7515.
Content-Type
Опционально в header
string
application/json
Accept
Опционально в header
string
application/json
201
Created
422
Request invalid
500
Internal server error
Пример запроса
curl --request POST \
--url https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-jws-signature: REPLACE_THIS_VALUE' \
--data '{"id":52672307,"srvId":"1","amount":100,"currency":"KZT","extRefNo":"129783","point":"Пункт оплаты","status":"vawamcanmuodabi","statusName":"Antonio Simmons","createDate":"10/20/2044","finishDate":"2/6/2064","srvParams":[{"code":"agreement","name":"Код услуги","note":"null","min":"1","max":"10","regexpMask":"null","regexpChk":"null","prmType":"0","chkCode":"null","value":"65.53","valueList":[{"value":"913","note":"Штрафы за нарушение законодательства Республики Казахстан"}]}],"register":[{"_any_":"tipeze"}],"accept":"0","terminal":"88888888","fee":10,"authcode":"965825","rrn":"9856321589632","card":"489999******6236"}'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Post.new(url)
request["x-jws-signature"] = 'REPLACE_THIS_VALUE'
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}"
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
payload = "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}"
headers = {
'x-jws-signature': "REPLACE_THIS_VALUE",
'content-type': "application/json",
'accept': "application/json"
}
conn.request("POST", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}",
CURLOPT_HTTPHEADER => array(
"accept: application/json",
"content-type: application/json",
"x-jws-signature: REPLACE_THIS_VALUE"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}");
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions")
.post(body)
.addHeader("x-jws-signature", "REPLACE_THIS_VALUE")
.addHeader("content-type", "application/json")
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'POST',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions',
headers:
{ accept: 'application/json',
'content-type': 'application/json',
'x-jws-signature': 'REPLACE_THIS_VALUE' },
body:
{ id: 52672307,
srvId: '1',
amount: 100,
currency: 'KZT',
extRefNo: '129783',
point: 'Пункт оплаты',
status: 'vawamcanmuodabi',
statusName: 'Antonio Simmons',
createDate: '10/20/2044',
finishDate: '2/6/2064',
srvParams:
[ { code: 'agreement',
name: 'Код услуги',
note: 'null',
min: '1',
max: '10',
regexpMask: 'null',
regexpChk: 'null',
prmType: '0',
chkCode: 'null',
value: '65.53',
valueList:
[ { value: '913',
note: 'Штрафы за нарушение законодательства Республики Казахстан' } ] } ],
register: [ { _any_: 'tipeze' } ],
accept: '0',
terminal: '88888888',
fee: 10,
authcode: '965825',
rrn: '9856321589632',
card: '489999******6236' },
json: true };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions"
payload := strings.NewReader("{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-jws-signature", "REPLACE_THIS_VALUE")
req.Header.Add("content-type", "application/json")
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = [
"x-jws-signature": "REPLACE_THIS_VALUE",
"content-type": "application/json",
"accept": "application/json"
]
let parameters = [
"id": 52672307,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "vawamcanmuodabi",
"statusName": "Antonio Simmons",
"createDate": "10/20/2044",
"finishDate": "2/6/2064",
"srvParams": [
[
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "65.53",
"valueList": [
[
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
]
]
]
],
"register": [["_any_": "tipeze"]],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
]
let postData = NSJSONSerialization.dataWithJSONObject(parameters, options: nil, error: nil)
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "POST"
request.allHTTPHeaderFields = headers
request.HTTPBody = postData
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "x-jws-signature: REPLACE_THIS_VALUE");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}");
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("content-type", "application/json");
request.AddHeader("x-jws-signature", "REPLACE_THIS_VALUE");
request.AddParameter("application/json", "{\"id\":52672307,\"srvId\":\"1\",\"amount\":100,\"currency\":\"KZT\",\"extRefNo\":\"129783\",\"point\":\"Пункт оплаты\",\"status\":\"vawamcanmuodabi\",\"statusName\":\"Antonio Simmons\",\"createDate\":\"10/20/2044\",\"finishDate\":\"2/6/2064\",\"srvParams\":[{\"code\":\"agreement\",\"name\":\"Код услуги\",\"note\":\"null\",\"min\":\"1\",\"max\":\"10\",\"regexpMask\":\"null\",\"regexpChk\":\"null\",\"prmType\":\"0\",\"chkCode\":\"null\",\"value\":\"65.53\",\"valueList\":[{\"value\":\"913\",\"note\":\"Штрафы за нарушение законодательства Республики Казахстан\"}]}],\"register\":[{\"_any_\":\"tipeze\"}],\"accept\":\"0\",\"terminal\":\"88888888\",\"fee\":10,\"authcode\":\"965825\",\"rrn\":\"9856321589632\",\"card\":\"489999******6236\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);Пример ответа
POST https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions
{
"id": 48548725,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "semguvonmoz",
"statusName": "Barry Hanson",
"createDate": "9/14/2060",
"finishDate": "9/7/2037",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "69.97",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "ewaniepratuw"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}Попробуйте выполнить эту операцию
/{agent}/transactions/{extRefId}
get /{agent}/transactions/{extRefId}
Транзакции
Получение деталей транзакции
Операция по получению деталей транзакции
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
extRefId
Required in path
string
Уникальный идентификатор транзакции в информационной системе Агента
register
Опционально в query
integer / integer
Признак вывода реестра списочного платежа при его наличии. По умолчанию 0.
{
"enum": [
0,
1
]
}Accept
Опционально в header
string
application/json
200
OK
500
Internal Server Error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID',
qs: { register: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID?register=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions/{extRefId}
{
"id": 82333701,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "sabkigmukuke",
"statusName": "Adeline Richardson",
"createDate": "3/11/2086",
"finishDate": "7/12/2095",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "36.94",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "hana"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}Попробуйте выполнить эту операцию
/{agent}/transactions/{extRefId}/accept
put /{agent}/transactions/{extRefId}/accept
Транзакции
Подтверждение транзакции
Запрос на подтверждение транзакции в случае если при создании транзакции параметр accept = 1
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
extRefId
Required in path
string
Уникальный идентификатор транзакции в информационной системе Агента
Accept
Опционально в header
string
application/json
200
OK
500
Internal server error
Пример запроса
curl --request PUT \
--url https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("PUT", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept")
.put(null)
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'PUT',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept',
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "PUT"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/accept");
var request = new RestRequest(Method.PUT);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
PUT https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions/{extRefId}/accept
{
"id": 12463986,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "epow",
"statusName": "Johanna Chandler",
"createDate": "11/24/2062",
"finishDate": "12/23/2095",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "73.8",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "zivepucc"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}Попробуйте выполнить эту операцию
/{agent}/transactions/{extRefId}/decline
put /{agent}/transactions/{extRefId}/decline
Транзакции
Отклонение транзакции
Запрос на отклонение ранее введеной в платежный шлюз операции в случае если при создании транзакции параметр accept = 1
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
extRefId
Required in path
string
Уникальный идентификатор транзакции в информационной системе Агента
Accept
Опционально в header
string
application/json
200
OK
500
Internal server error
Пример запроса
curl --request PUT \
--url https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("PUT", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline")
.put(null)
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'PUT',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline',
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "PUT"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/decline");
var request = new RestRequest(Method.PUT);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
PUT https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions/{extRefId}/decline
{
"id": 34167812,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "vesinajuzu",
"statusName": "Timothy Castillo",
"createDate": "1/9/2090",
"finishDate": "4/30/2124",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "56.74",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "ejaeftofavimpo"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}Попробуйте выполнить эту операцию
/{agent}/transactions/{extRefId}/redo
put /{agent}/transactions/{extRefId}/redo
Транзакции
Перепроведение транзакции
Запрос на перепроведение транзакции. Используется при технических проблеммах связанных с проведением транзакции в АБС Банка.
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
extRefId
Required in path
string
Уникальный идентификатор транзакции в информационной системе Агента
Accept
Опционально в header
string
application/json
200
OK
500
Internal server error
Пример запроса
curl --request PUT \
--url https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("PUT", "/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo")
.put(null)
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'PUT',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo',
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "PUT"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/transactions/REPLACE_EXTREFID/redo");
var request = new RestRequest(Method.PUT);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
PUT https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/transactions/{extRefId}/redo
{
"id": 16316667,
"srvId": "1",
"amount": 100,
"currency": "KZT",
"extRefNo": "129783",
"point": "Пункт оплаты",
"status": "lutuduswinolo",
"statusName": "Hallie Sutton",
"createDate": "8/28/2100",
"finishDate": "1/13/2082",
"srvParams": [
{
"code": "agreement",
"name": "Код услуги",
"note": "null",
"min": "1",
"max": "10",
"regexpMask": "null",
"regexpChk": "null",
"prmType": "0",
"chkCode": "null",
"value": "43.59",
"valueList": [
{
"value": "913",
"note": "Штрафы за нарушение законодательства Республики Казахстан"
}
]
}
],
"register": [
{
"_any_": "defovadubofutm"
}
],
"accept": "0",
"terminal": "88888888",
"fee": 10,
"authcode": "965825",
"rrn": "9856321589632",
"card": "489999******6236"
}Попробуйте выполнить эту операцию
/{agent}/reconciliation
post /{agent}/reconciliation
Отчеты, сверки, баланс
Автоматическая сверка операций
Операция по автоматической сверке реестра проведенных платежей за указаный период
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
x-jws-signature
Required in header
string
JSON сообщение с ЭЦП и сертификатом в формате Base64. Дополнительная информация инструкции по работе с ЭЦП, а также в RFC 7515.
rewrite
Required in query
integer / int32
Признак необходимости перезаписи реестра
register
Required in body
object
Реестр транзакций
Content-Type
Опционально в header
string
application/json
Accept
Опционально в header
string
application/json
200
422
Request invalid
500
Internal Server Error
Пример запроса
curl --request POST \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-jws-signature: REPLACE_THIS_VALUE' \
--data '{"dtFrom":"2019-04-19","dtTo":"2019-04-19","amount":100000,"currency":"KZT","records":[{"extRefNo":"123456789","amount":1000,"trnDate":"2019-04-19T16:27:42","currency":"KZT","note":"Транзакция с референсом ххххх не найдена в системе Банка"}]}'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Post.new(url)
request["x-jws-signature"] = 'REPLACE_THIS_VALUE'
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}"
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
payload = "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}"
headers = {
'x-jws-signature': "REPLACE_THIS_VALUE",
'content-type': "application/json",
'accept': "application/json"
}
conn.request("POST", "/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}",
CURLOPT_HTTPHEADER => array(
"accept: application/json",
"content-type: application/json",
"x-jws-signature: REPLACE_THIS_VALUE"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}");
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE")
.post(body)
.addHeader("x-jws-signature", "REPLACE_THIS_VALUE")
.addHeader("content-type", "application/json")
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'POST',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation',
qs: { rewrite: 'REPLACE_THIS_VALUE' },
headers:
{ accept: 'application/json',
'content-type': 'application/json',
'x-jws-signature': 'REPLACE_THIS_VALUE' },
body:
{ dtFrom: '2019-04-19',
dtTo: '2019-04-19',
amount: 100000,
currency: 'KZT',
records:
[ { extRefNo: '123456789',
amount: 1000,
trnDate: '2019-04-19T16:27:42',
currency: 'KZT',
note: 'Транзакция с референсом ххххх не найдена в системе Банка' } ] },
json: true };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE"
payload := strings.NewReader("{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-jws-signature", "REPLACE_THIS_VALUE")
req.Header.Add("content-type", "application/json")
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = [
"x-jws-signature": "REPLACE_THIS_VALUE",
"content-type": "application/json",
"accept": "application/json"
]
let parameters = [
"dtFrom": "2019-04-19",
"dtTo": "2019-04-19",
"amount": 100000,
"currency": "KZT",
"records": [
[
"extRefNo": "123456789",
"amount": 1000,
"trnDate": "2019-04-19T16:27:42",
"currency": "KZT",
"note": "Транзакция с референсом ххххх не найдена в системе Банка"
]
]
]
let postData = NSJSONSerialization.dataWithJSONObject(parameters, options: nil, error: nil)
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "POST"
request.allHTTPHeaderFields = headers
request.HTTPBody = postData
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "x-jws-signature: REPLACE_THIS_VALUE");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}");
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reconciliation?rewrite=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("content-type", "application/json");
request.AddHeader("x-jws-signature", "REPLACE_THIS_VALUE");
request.AddParameter("application/json", "{\"dtFrom\":\"2019-04-19\",\"dtTo\":\"2019-04-19\",\"amount\":100000,\"currency\":\"KZT\",\"records\":[{\"extRefNo\":\"123456789\",\"amount\":1000,\"trnDate\":\"2019-04-19T16:27:42\",\"currency\":\"KZT\",\"note\":\"Транзакция с референсом ххххх не найдена в системе Банка\"}]}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);Пример ответа
POST https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/reconciliation
{
"code": "0",
"description": "Успешно",
"notMatchingList": [
{
"extRefNo": "123456789",
"amount": 1000,
"trnDate": "2019-04-19T16:27:42",
"currency": "KZT",
"note": "Транзакция с референсом ххххх не найдена в системе Банка"
}
]
}Попробуйте выполнить эту операцию
/{agent}/balance
get /{agent}/balance
Отчеты, сверки, баланс
Получение текущего баланса агента
Операция по получению текущего баланса на счете агента
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
Accept
Опционально в header
string
application/json
Пример запроса
curl --request GET \
--url https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/balance", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance',
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/balance");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/balance
{
"balance": 109000,
"processed": 10900,
"threshold": 1000000
}Попробуйте выполнить эту операцию
/{agent}/statement
get /{agent}/statement
Отчеты, сверки, баланс
Получение выписки с операциями по счету Банка
Операция по получению постраничной выписки с операциями по счету Банка
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
dt
Required in query
string
Операционная дата выписки. Формат: dd.MM.yyyy
page
Опционально в query
integer
Номер страницы для вывода операций, общее количество страниц выписки указанно в аттрибуте totalPage ответа. По умолчанию 1
Accept
Опционально в header
string
application/json
200
OK
401
Unauthorized
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement',
qs: { dt: 'REPLACE_THIS_VALUE', page: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/statement?dt=REPLACE_THIS_VALUE&page=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/statement
{
"inBalance": 10.01,
"outBalance": 20.01,
"currentPage": 21,
"totalPage": 56,
"operations": [
{
"extRefNo": "EXT1234566",
"date": "19-09-2020 17:00:00",
"type": "debit",
"account": "KZ000000000000000001",
"bank": "KCJBKZKX",
"idn": "000000000000",
"name": "Bess Santiago",
"amount": 10.01,
"currency": "KZT",
"knp": "911",
"narrative": "Платёж СБВ"
}
]
}Попробуйте выполнить эту операцию
/{agent}/reports
get /{agent}/reports
Отчеты, сверки, баланс
Формирование отчетов
Формирование отчетов
Authorization
Authorization
(oauth2 application)
Токен аутентификации полученый при вызове сервиса авторизации
Token URL
https://api.bcc.kz/bcc/production/v1/oauth2/token
Scopes
access_payment_gateway
Allow access to Payment gateway API
agent
Required in path
string
Уникальный идентификатор агента полученный в Банке при заключении Договора
report
Required in query
string
Наименование отчета
{
"enum": [
"getReturnReport"
]
}dtFrom
Опционально в query
string
Дата начала периода. Формат: dd.MM.yyyy
dtTo
Опционально в query
string
Дата окончания периода. Формат: dd.MM.yyyy
Accept
Опционально в header
string
application/json
200
500
Internal server error
Пример запроса
curl --request GET \
--url 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE' \
--header 'accept: application/json'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("api.bcc.kz:10443")
headers = { 'accept': "application/json" }
conn.request("GET", "/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_PORT => "10443",
CURLOPT_URL => "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE")
.get()
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'GET',
url: 'https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports',
qs:
{ report: 'REPLACE_THIS_VALUE',
dtFrom: 'REPLACE_THIS_VALUE',
dtTo: 'REPLACE_THIS_VALUE' },
headers: { accept: 'application/json' } };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = ["accept": "application/json"]
var request = NSMutableURLRequest(URL: NSURL(string: "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "GET"
request.allHTTPHeaderFields = headers
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);var client = new RestClient("https://api.bcc.kz:10443/bcc/production/v1/pgs/REPLACE_AGENT/reports?report=REPLACE_THIS_VALUE&dtFrom=REPLACE_THIS_VALUE&dtTo=REPLACE_THIS_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);Пример ответа
GET https://api.bcc.kz:10443/bcc/production/v1/pgs/{agent}/reports
{
"_any_": "piphadeccacjos",
"reportRows": [
{
"_any_": "adefdiflu",
"reportRows": {
"circular_reference": "#/definitions/reportRow"
}
}
]
}Попробуйте выполнить эту операцию
Определения
Объект, описывающий услугу
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор услуги",
"example": "2"
},
"code": {
"type": "string",
"description": "Код услуги",
"example": "uib"
},
"name": {
"type": "string",
"description": "Наименование услуги",
"example": "UIB"
},
"note": {
"type": "string",
"description": "Примечание",
"example": "Оплата за обучение"
},
"chktype": {
"type": "string",
"description": "Тип проверки",
"example": "getContractByIin"
},
"params": {
"$ref": "#\/definitions\/svcParams",
"description": "Параметры услуги"
},
"register": {
"description": "Реестр",
"$ref": "#\/definitions\/svcParams"
}
}
}
Описание ответа для метода получения информации об услугах
{
"type": "object",
"properties": {
"categories": {
"$ref": "#\/definitions\/categories",
"description": "Объект, возвращаемый в случае ответа 'С категориями'"
},
"services": {
"$ref": "#\/definitions\/services",
"description": "Объект, возвращаемый в случае ответа 'Без категорий'"
}
}
}
Описание категории услуг
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Код",
"example": "education"
},
"name": {
"type": "string",
"description": "Наименование",
"example": "Обучение"
},
"categories": {
"$ref": "#\/definitions\/categories",
"description": "Дочерние (зависимые) категории"
},
"services": {
"$ref": "#\/definitions\/services",
"description": "Услуги, включённые в категорию"
}
}
}
Массив категорий
{
"type": "array",
"items": {
"$ref": "#\/definitions\/category"
}
}
Массив услуг
{
"type": "array",
"items": {
"$ref": "#\/definitions\/service"
}
}
Объект комиссии
{
"type": "object",
"properties": {
"amount": {
"type": "string",
"description": "Сумма"
},
"currency": {
"type": "string",
"description": "Валюта"
}
}
}
Массив наборов параметров услуги
{
"type": "array",
"items": {
"type": "string"
}
}
Массив параметров
{
"type": "array",
"items": {
"$ref": "#\/definitions\/svcParam"
}
}
Описание параметра сервиса и ограничений по нему для корректной работы с услугой.
Параметр **{prmType} тип операции предусматривает передачу на сторону агента типа параметра для описания возможных операции с данным параметром на стороне агента
| Код | Тип | Описание |
|---|---|---|
| 0 | in | Входящий параметр |
| 1 | out | Выходящий без возможности редактирования (Изменение параметра на стороне агента не учитывается в сервисе проведения платежа) |
| 2 | in/out | Выходящий с возможностью редактирования (Допускается изменение на стороне агента для последующей передачи в сервисы) |
| 3 | out | Информационный (Используется для передачи дополнительных информационных параметров) |
| 4 | out | Выходяший в виде списка без возможности редактирования (например справочник доступных КНП или КБК по услуге) |
| 5 | out | Выходяший в виде списка c возможностью редактирования (например список известных VIN кодов для клиента при оплате штрафов) |
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Код",
"example": "agreement"
},
"name": {
"type": "string",
"description": "Наименование",
"example": "Код услуги"
},
"note": {
"type": "string",
"description": "Примечание",
"example": "null"
},
"min": {
"type": "string",
"description": "Минимальная длина",
"example": "1"
},
"max": {
"type": "string",
"description": "Максимальная длина",
"example": "10"
},
"regexpMask": {
"type": "string",
"description": "Регулярное выражение для валидации параметра при создании транзакции",
"example": "null"
},
"regexpChk": {
"type": "string",
"description": "Регулярное выражение для валидации параметра при онлайн-проверке",
"example": "null"
},
"prmType": {
"type": "string",
"example": "0",
"description": "Тип параметра"
},
"chkCode": {
"type": "string",
"description": "Код при онлайн-проверки",
"example": "null"
},
"value": {
"type": "string",
"description": "Значение параметра"
},
"valueList": {
"description": "Список значений параметра",
"$ref": "#\/definitions\/valueList"
}
}
}
Описание параметра ответа онлайн-проверки
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Код"
},
"prmType": {
"type": "string",
"description": "Тип параметра"
},
"value": {
"type": "string",
"description": "Значение параметра"
},
"valueMask": {
"type": "string",
"description": "Усечённое значение параметра для отображения"
},
"valueList": {
"type": "string",
"description": "Список значений. Поле используется при prmType = 4 или 5"
}
}
}
Массив параметров ответа онлайн-проверки
{
"type": "array",
"items": {
"$ref": "#\/definitions\/chkParam"
}
}
Массив возвращаемых сущностей ответа онлайн-проверки
{
"type": "array",
"items": {
"$ref": "#\/definitions\/chkParams"
}
}
Параметр транзакции
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Код параметра"
},
"value": {
"type": "string",
"description": "Значение параметра"
}
}
}
Массив параметров транзакции
{
"type": "array",
"items": {
"$ref": "#\/definitions\/trnParam"
}
}
Описание транзакции
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Идентификатор транзакции"
},
"srvId": {
"type": "integer",
"description": "Идентификатор услуги",
"example": "1"
},
"amount": {
"type": "number",
"description": "Сумма транзакции",
"example": 100
},
"currency": {
"type": "string",
"description": "Валюта транзакции",
"example": "KZT"
},
"extRefNo": {
"type": "string",
"description": "Референс во внешней системе",
"example": "129783"
},
"point": {
"type": "string",
"description": "Наименование точки предоставления услуги (ID терминала, отделения, наименование сервиса и т.д.)",
"example": "Пункт оплаты"
},
"status": {
"type": "string",
"description": "Статус транзакции"
},
"statusName": {
"type": "string",
"description": "Описание статуса"
},
"createDate": {
"type": "string",
"description": "Дата создания транзакции"
},
"finishDate": {
"type": "string",
"description": "Дата завершения транзакции"
},
"srvParams": {
"$ref": "#\/definitions\/svcParams",
"description": "Параметры услуги"
},
"register": {
"$ref": "#\/definitions\/arrayObjects",
"description": "Реестр в рамках проведения списочных платежей, согласно спецификации на услугу",
"items": {
"type": "string"
}
},
"accept": {
"type": "integer",
"description": "Признак ожидания одобрения платежа. 0 - автоодобрение (по умолчанию), 1 - одобрение платежа вызовом сервиса \/accept",
"example": "0",
"format": "int32"
},
"terminal": {
"type": "string",
"description": "Уникальный идентификатор терминала. Используется при оплате услуг через ECommerce шлюз АО \"Банк ЦентрКредит\"",
"example": "88888888"
},
"fee": {
"type": "number",
"description": "Комиссия, которая взимается агентом",
"example": 10,
"format": "float"
},
"authcode": {
"type": "string",
"description": "Код авторизации",
"example": "965825"
},
"rrn": {
"type": "string",
"description": "RRN Транзакции",
"example": "9856321589632"
},
"card": {
"type": "string",
"description": "Маскированный номер карты, по которой была осуществлена оплата. Формат: 000000****** 0000",
"example": "489999******6236"
}
},
"required": [
"srvId",
"amount",
"currency",
"fee",
"extRefNo"
],
"additionalProperties": false
}
Массив транзакций
{
"type": "array",
"items": {
"$ref": "#\/definitions\/transaction"
}
}
{
"type": "object",
"properties": {
"inBalance": {
"type": "number",
"description": "Входящий баланс на начало периода",
"example": 10.01
},
"outBalance": {
"type": "number",
"description": "Исходящий баланс на начало периода",
"example": 20.01
},
"currentPage": {
"type": "integer",
"description": "Номер текущей страницы",
"example": 21
},
"totalPage": {
"type": "integer",
"description": "Количество страниц в выписке",
"example": 56
},
"operations": {
"$ref": "#\/definitions\/operations"
}
}
}
{
"type": "array",
"items": {
"$ref": "#\/definitions\/operation"
}
}
{
"type": "object",
"properties": {
"extRefNo": {
"type": "string",
"description": "Идентификатор операции в информационной системе клиента",
"example": "EXT1234566"
},
"date": {
"type": "string",
"description": "Дата и время проведения операции. Формат: yyyy-MM-dd HH:mm:ss",
"example": "19-09-2020 17:00:00"
},
"type": {
"type": "string",
"description": "Тип операции. debit - дебет счета, credit - кредит счета",
"example": "debit"
},
"account": {
"type": "string",
"description": "IBAN. 20 значный номер счета",
"example": "KZ000000000000000001"
},
"bank": {
"type": "string",
"description": "Идентификационный код банка (БИК)",
"example": "KCJBKZKX"
},
"idn": {
"type": "string",
"description": "Идентификационный номер участника операции",
"example": "000000000000"
},
"name": {
"type": "string",
"description": "Наименование участника операции"
},
"amount": {
"type": "number",
"example": 10.01,
"description": "Сумма операции"
},
"currency": {
"type": "string",
"example": "KZT",
"description": "Валюта операции согласно стандарта ISO 4217 (KZT, USD, EUR)"
},
"knp": {
"type": "string",
"example": "911",
"description": "КНП операции"
},
"narrative": {
"type": "string",
"example": "Платёж СБВ",
"description": "Назначение операции"
}
},
"required": [
"extRefNo",
"account",
"amount",
"date",
"type"
]
}
{
"type": "object",
"properties": {
"_any_": {
"type": "string",
"description": "Параметры отчета"
},
"reportRows": {
"$ref": "#\/definitions\/reportRows"
}
}
}
{
"type": "array",
"items": {
"$ref": "#\/definitions\/reportRow"
}
}
Строка отчета
{
"type": "object",
"properties": {
"_any_": {
"type": "string",
"description": "Аттрибут строки отчета"
},
"reportRows": {
"$ref": "#\/definitions\/reportRows"
}
}
}
Описывает цифровую подпись примененную при подписании сообщения. Дополнительные сведения приведены в раздел 4 RFC 7515 ( https://tools.ietf.org/html/rfc7515#page-9 )
{
"properties": {
"x5c": {
"type": "array",
"items": {
"type": "string"
},
"description": "Содержит публичный ключ сертификата X.509 или цепочку сертификатов. Дополнителные сведения RFC 7515 раздел 4.1.2.",
"example": "[\"X.509-1\",\"X.509-2\"]"
},
"alg": {
"type": "string",
"description": "Используемый криптографический алгоритм. Дополнителные сведения RFC 7515 раздел 4.1.2.",
"example": "\"RS256\""
}
},
"additionalProperties": false
}
Сообщение для шлюза подписанное в соответствии с стандартом JSON Web Signature (https://tools.ietf.org/html/rfc7515)
{
"properties": {
"payload": {
"type": "string",
"example": "eyJzcnZJZCI6MSwiYW1vdW50IjoxMDAsImN......1cnJl",
"description": "Исходное сообщение JSON закодированное в Base64 которое требуется подписать ЭЦП"
},
"signatures": {
"$ref": "#\/definitions\/jws-signatures",
"description": "Массив электронных подписей подписавших сообщений."
}
},
"additionalProperties": false,
"required": [
"payload",
"signatures"
]
}
Маccив электронных подписей подписавших сообщение.
{
"type": "array",
"items": {
"$ref": "#\/definitions\/jws-signature"
}
}
Определяет параметры подписи и саму подпись для подписанного сообщения (JWS Payload) и защищенных заголовков сообщения. Дополнительная информация RFC 7515 раздел 7.2.1.
{
"properties": {
"header": {
"$ref": "#\/definitions\/jose-header",
"description": "Заголовки описывающие электронную подпись."
},
"signature": {
"type": "string",
"description": "Электронная подпись сообщения."
}
},
"additionalProperties": false,
"required": [
"header",
"signature"
]
}
Подписанное ЭЦП зарегистрированной в банке сообщение в формате JWS JSON Serialization представленное в формате base64url(jws-message). Дополнительная информация RFC 7515 раздел 3.2.
{
"type": "string"
}
Реестр проведенных операций
{
"properties": {
"dtFrom": {
"type": "string",
"description": "Период реестра с",
"format": "date",
"example": "2019-04-19"
},
"dtTo": {
"type": "string",
"description": "Период реестра по",
"format": "date",
"example": "2019-04-19"
},
"amount": {
"type": "number",
"description": "Сумма реестра",
"format": "double",
"example": 100000
},
"currency": {
"type": "string",
"enum": [
"KZT",
"USD",
"EUR"
],
"description": "Валюта реестра согласно стандарта ISO 4217 (KZT, USD, EUR)",
"example": "KZT"
},
"records": {
"description": "Массив записей реестра транзакций для проведения автоматической сверки",
"items": {
"type": "string"
},
"$ref": "#\/definitions\/registerRecords"
}
},
"additionalProperties": false,
"required": [
"dtFrom",
"dtTo",
"amount",
"currency",
"records"
]
}
Список транзакций для проведения автоматической сверки
{
"type": "array",
"items": {
"$ref": "#\/definitions\/registerRecord"
}
}
Описание полей транзакции в отчете по автоматической сверке
{
"properties": {
"extRefNo": {
"type": "string",
"description": "Уникальный идентификатор транзакции в информационной системе Агента",
"example": "123456789"
},
"amount": {
"type": "number",
"description": "Сумма транзакции",
"example": 1000
},
"trnDate": {
"type": "string",
"description": "Дата проведения транзакции на стороне Агента. Формат YYYY-MM-DDThh:mm:ss (ISO 8601)",
"example": "2019-04-19T16:27:42",
"format": "date-time"
},
"currency": {
"type": "string",
"description": "Валюта реестра согласно стандарта ISO 4217 (KZT, USD, EUR)",
"example": "KZT"
},
"note": {
"type": "string",
"description": "Описание не соответствия при проведении автоматической стороне. Заполняется в ответе Банка",
"example": "Транзакция с референсом ххххх не найдена в системе Банка"
}
},
"additionalProperties": false,
"required": [
"amount",
"trnDate",
"currency",
"extRefNo"
]
}
Информация о результате вызова запроса
{
"properties": {
"success": {
"type": "boolean",
"description": "Признак результата выполнения запроса",
"example": "true"
},
"code": {
"type": "string",
"description": "Код выполнения"
},
"status": {
"type": "string",
"description": "Статус выполнения"
},
"reason": {
"type": "string",
"description": "Код результата выполнения запроса",
"example": "0"
},
"description": {
"type": "string",
"description": "Описание результата выполнения запроса",
"example": "Успешно"
}
},
"additionalProperties": false,
"required": [
"success",
"reason"
]
}
Результаты автоматической сверки
{
"properties": {
"code": {
"type": "string",
"description": "Код результата выполнения автоматической сверки. 1 - сверка успешна, 2 - при сверке выявлены не соответствия",
"example": "0"
},
"description": {
"type": "string",
"description": "Описание кода результата выполнения автоматической сверки",
"example": "Успешно"
},
"notMatchingList": {
"description": "Список транзакций не соответствующих входящему реестру. Заполняется при code = 2",
"$ref": "#\/definitions\/registerRecords"
}
},
"additionalProperties": false,
"required": [
"code"
]
}
Список допустимых значений
{
"type": "array",
"items": {
"$ref": "#\/definitions\/value"
}
}
Допустимое значение для параметров
{
"properties": {
"value": {
"type": "string",
"description": "Значение параметра",
"example": "913"
},
"note": {
"type": "string",
"description": "Представление значения для пользователя",
"example": "Штрафы за нарушение законодательства Республики Казахстан"
}
},
"additionalProperties": false,
"required": [
"value"
]
}
Информация о балансе на счете агента
Примечание: Параметр threshold возвращается только по агентам, которые работают по предоплате
{
"properties": {
"balance": {
"type": "number",
"description": "Балансе на счете агента",
"format": "float",
"example": 109000
},
"processed": {
"type": "number",
"description": "Сумма транзакций в обработке",
"format": "float",
"example": 10900
},
"threshold": {
"type": "number",
"description": "Неснижаемый остаток",
"format": "float",
"example": 1000000
}
},
"additionalProperties": false,
"required": [
"balance",
"processed"
]
}
Абстрактный массив объектов со структурой описываемой в спецификации услуги. Используется в таких услугах как списочные платежи (пенсионные, социальные отчисления и т.п.)
{
"type": "array",
"items": {
"$ref": "#\/definitions\/arrayObject"
}
}
Объект с описанием полей и ограничений в технической спецификации услуги
{
"properties": {
"_any_": {
"type": "string",
"description": "Абстрактный параметр описаний в технической спецификации услуги"
}
},
"additionalProperties": true
}