Проверка остатка баланса на счету

В ближайшее время в нашей системе ошибки будут разделены на ожидаемые и неожидаемые. Это приведет к изменению формата JSON-ответа в зависимости от типа ошибки. Пожалуйста, ознакомьтесь с изменениями на странице Коды Ошибок. Изменения будут применены ко всем API в системе AGWS, за исключением методов «Проведение платежа» и «Проверка статуса пополнения».

Нажмите здесь, чтобы просмотреть старые и новые ответы об ошибках JSON. Обратите внимание на это обновление и убедитесь, что ваша система готова к изменениям, если это необходимо.

POST https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/showcase/balance

Headers

Name	Value
Content-Type	application/json
X-Signature	Авторизационный хэш

Body

Name	Type	Description
agent*	String	Код витрины в системе Tarlan

Response

Name	Type	Description
status	bool	Статус обработки запроса
status_code	uint	Код ошибки
message	string	Описание ошибки
result	Object	Результат запроса, в котором содержится информация
-showcase_code	String	Код витрины в системе Tarlan
-balance	float	Текущий баланс

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

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "showcase_code": "daw",
        "balance": 0
    }
}

Примеры ответов об ошибках до внесения изменений

404 Not Found

{
    "status": false,
    "status_code": 8015,
    "message": "account doesn't exist",
    "result": {}
}

400 Bad Request

{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

Примеры ответов об ошибках после внесения изменений

200 OK: Ожидаемая ошибка

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 8015,
        "message": "account doesn't exist",
        "data": {},
        "additional_data": {}
    }
}

400 Bad Request: Неожидаемая ошибка

{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

Проверка баланса

Go

package main

import (
	"bytes"
	"crypto/sha256"
	"encoding/base64"
	"encoding/hex"
	"encoding/json"
	"io/ioutil"
	"log"
	"net/http"
	"sort"
	"strconv"
)

const (
	// agent - код витрины на стороне Tarlan
	agent = "agent"
	// url - URL для отправки запроса
	url = "https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/showcase/balance"
	// secret -secret проекта
	secret = "12345"
)

// Response представляет ответ от сервера
type Response struct {
	Status     bool   `json:"status"`
	StatusCode int    `json:"status_code"`
	Message    string `json:"message"`
	Result     Result `json:"result"`
}

type Result struct {
	ShowcaseCode string  `json:"showcase_code"`
	Message      string  `json:"message"`
	Balance      float64 `json:"balance"`
}

// Body представляет структуру запроса
type Body struct {
	Agent string `json:"agent"`
}

// MakeSign генерирует подпись для HTTP-запроса
func MakeSign(body Body, secretKey string) (string, error) {
	// Конвертируем структуру в map для сортировки
	dataMap := make(map[string]interface{})
	jsonData, _ := json.Marshal(body)
	json.Unmarshal(jsonData, &dataMap)

	// Удаляем "additional_data", если нужно
	delete(dataMap, "additional_data")

	// Сортируем ключи по алфавиту
	keys := make([]string, 0, len(dataMap))
	for key := range dataMap {
		keys = append(keys, key)
	}
	sort.Strings(keys)

	// Создаем отсортированный JSON
	sortedData := make(map[string]interface{})
	for _, key := range keys {
		sortedData[key] = dataMap[key]
	}

	// Преобразуем отсортированные данные в JSON
	sortedJson, err := json.Marshal(sortedData)
	if err != nil {
		return "", err
	}

	// Кодируем JSON в base64
	base64EncodedData := base64.StdEncoding.EncodeToString(sortedJson)
	// Конкатенируем base64-данные с секретом
	dataToSign := base64EncodedData + secretKey

	// Хешируем SHA-256
	sha256Hash := sha256.Sum256([]byte(dataToSign))
	sign := hex.EncodeToString(sha256Hash[:])

	return sign, nil
}

// CheckBalance отправляет POST-запрос и обрабатывает ответ
func CheckBalance(body Body, url, signature string) (string, error) {
	// Конвертируем структуру в JSON для отправки
	jsonData, err := json.Marshal(body)
	if err != nil {
		return "", err
	}

	// Создаем и отправляем POST-запрос
	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
	if err != nil {
		return "", err
	}

	// Устанавливаем подпись запроса
	req.Header.Set("X-Signature", signature)
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		return "", err
	}
	defer resp.Body.Close()

	// Чтение и обработка ответа
	bodyBytes, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		return "", err
	}
	jsonResponse := string(bodyBytes)

	// Структура для парсинга ответа
	var response Response
	err = json.Unmarshal([]byte(jsonResponse), &response)
	if err != nil {
		return "", err
	}

	log.Printf("Status-%v, %v", resp.StatusCode, jsonResponse)

	// Определение поля message
	var message string

	// Извлечение ответа
	if resp.StatusCode == http.StatusOK {
	if response.StatusCode == 0 {
	balance := strconv.FormatFloat(response.Result.Balance, 'f', -1, 64)
	message = "Showcase " + response.Result.ShowcaseCode + " balance is " + balance
	} else {
	message = response.Result.Message
	}
	} else {
	message = response.Message
	}

	// Вывод ответа и результата
	return message, nil
}

func main() {

	// URL Запроса
	RequestURL := url
	// Secret Проекта
	SecretKey := secret
	// Тело запроса
	requestBody := Body{
		Agent: agent,
	}

	// Генерация заголовка
	sign, err := MakeSign(requestBody, SecretKey)
	if err != nil {
		log.Println("Error generating signature:", err)
		return
	}

	// Отправка запроса
	Message, err := CheckBalance(requestBody, RequestURL, sign)
	if err != nil {
		log.Panic("Error sending request", err)
		return
	}

	// Вывод message из лога
	if Message != "" {
		log.Println(Message)

	}

}