ПУМБ

Выполнение платежа Проверка возможности приема платежа CheckPaymentAvail

Thursday, October 26, 2023 11:38 PM

Проверка возможности приема платежа CheckPaymentAvail

После инициирования платежа магазином сервер банка обращается GET-запросом по CheckPaymentAvail URL магазина для проверки возможности совершения запрошенной покупки в магазине.

Параметры GET-запроса CheckPaymentAvail

Параметр Тип Описание
merch_id String Идентификатор магазина. Длина 32 символа.
trx_id String Идентификатор транзакции. Длина 32 символа.
ts String Дата и время выполнения запроса в формате Ymd H:i:s.
lang_code String Язык взаимодействия с клиентом. Двухсимвольный код в соответствии со стандартом ISO 639.
o.* String Дополнительные параметры заказа. Набор параметров и их названия определяются магазином на этапе инициирования платежа.

Пример GET-запроса CheckPaymentAvail

https://www.merchant.ua/check-payments-avail.php?trx_id=46622B749D0946EB37791DA383E315A9&lang_code=RU&merch_id=06A4A0FDA274668349DDC006D3CA0739&o.user_id=285167&o.amount=272.82&o.order_id=5907133&o.t_id=624292

Параметры ответа магазина на CheckPaymentAvail

По CheckPaymentAvail URL магазин отвечает банку в формате XML о возможности совершения запрошенной покупки.

Параметр Обязательность Тип Описание
result.code √ Number Результат проверки возможности проведения платежа. 1 — успешный, 2 — неуспешный.
result.desc √ String Описание результата. Максимальная длина 125 символов.
merchant-trx √ String Уникальный идентификатор транзакции магазина. Максимальная длина 50 символов.
purchase.shortDesc √ String Краткое описание покупки. Максимальная длина 30 символов.
purchase.longDesc √ String Развернутое описание покупки. Максимальная длина 125 символов.
purchase.account-amount.id String Идентификатор счета магазина. Длина 32 символа.
purchase.account-amount.amount √ Number Сумма платежа в минорных единицах. Целочисленное.
purchase.account-amount.currency √ Number Валюта платежа. Трёхзначный цифровой код в соответствии со стандартом ISO 4217.
purchase.account-amount.exponent √ Number Экспонента платежа.

Пример ответа магазина на CheckPaymentAvail при result.code = 1

<?xml version="1.0"?>
<payment-avail-response>
	<result>
		<code>1</code>
		<desc>OK</desc>
	</result>
	<merchant-trx>624292</merchant-trx>
	<purchase>
		<shortDesc>Краткое описание покупки.</shortDesc>
		<longDesc>Развернутое описание покупки.</longDesc>
		<account-amount>
			<id>A0CB3E876226313F6A7E2F220E7DFA1E</id>
			<amount>27282</amount>
			<currency>980</currency>
			<exponent>2</exponent>
		</account-amount>
	</purchase>
</payment-avail-response>

Пример ответа магазина на CheckPaymentAvail при result.code = 2

<?xml version="1.0"?>
<payment-avail-response>
	<result>
		<code>2</code>
		<desc>Unable to accept this payment.</desc>
	</result>
</payment-avail-response>