Skip to Content
docs
Регистрация картыРегистрация карты с оплатой

Регистрация карты с оплатой

Регистрация карты и одновременная обработка платежа. Карта будет сохранена для дальнейшего использования.

POST
***

Параметры запроса

NameTypeDescription
public_keyRequired
StringИдентификатор мерчанта. Пример: `i000000001`
languageRequired
StringЯзык отображения страницы. Значения: `az`, `en`, `ru`
order_idRequired
StringУникальный идентификатор заказа. Максимум 255 символов.
amountRequired
NumberСумма платежа. Пример: `100`, `20.50`
currencyRequired
StringВалюта платежа. Значения: `AZN`
descriptionOptional
StringОписание. Максимум 1000 символов.
success_redirect_urlOptional
StringURL перенаправления при успехе.
error_redirect_urlOptional
StringURL перенаправления при неудаче.

Пример запроса

Отправка запроса
Payload
{
  "public_key": "i000000001",
  "language": "az",
  "order_id": "order-123",
  "amount": 30.75,
  "currency": "AZN"
}
1DATA=$(echo -n '{"public_key":"i000000001","language":"az","order_id":"order-123","amount":30.75,"currency":"AZN"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3

4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Параметры ответа

NameTypeDescription
statusRequired
StringРезультат операции: `success` или `failed`
codeOptional
String`000` — успех
card_idOptional
StringУникальный идентификатор карты для будущих платежей
order_idOptional
StringУникальный идентификатор заказа
transactionOptional
StringИдентификатор транзакции Epoint
bank_transactionOptional
StringИдентификатор банковской транзакции
bank_responseOptional
StringОтвет банка
operation_codeOptional
String`200` — регистрация карты с первым платежом
rrnOptional
StringRetrieval Reference Number (только для успешных транзакций)
card_maskOptional
StringМаска карты в формате `123456******1234`
card_nameOptional
StringИмя держателя карты
amountOptional
NumberСумма платежа
other_attrOptional
ArrayДополнительные параметры
trace_idRequired
StringУникальный идентификатор запроса для отладки. Предоставьте его в службу поддержки Epoint для расследования проблемы.

Успех

Success Response
1{
2  "status": "success",
3  "code": "000",
4  "card_id": "card_abc123",
5  "order_id": "order_001",
6  "transaction": "te_0000000001",
7  "bank_transaction": "BT12345",
8  "bank_response": "000",
9  "operation_code": "200",
10  "rrn": "123456789012",
11  "card_mask": "123456******1234",
12  "card_name": "John Doe",
13  "amount": 30.75,
14  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
15}
Выполнить оплатуОбзор