Перейти к содержанию

Apple Pay Alternative

Вариант интеграции AM

Описание процесса оплаты

  1. Покупатель инициирует Apple Pay оплату на странице торговца.
  2. Торговец отправляет запрос оплаты в PacoPay Service Provider.
  3. PacoPay Service Provider возвращает торговцу ссылку для завершения оплаты.
  4. Торговец перенаправляет покупателя на полученную ссылку. По ссылке открывается страница, где отображена сумма транзакции и размещена кнопка для оплаты с помощью Apple Pay.
  5. Покупатель совершает оплату с помощью Apple Pay.
  6. PacoPay Service Provider высылает торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PacoPay Service Provider с помощью запроса получения статуса транзакции. Если транзакция успешна, уведомление или ответ на запрос статуса могут содержать параметр apple_pay_alt.account_number с маской карты.
Маска карты в автоматическом уведомлении 
{
  "transaction": {
  ...
    "apple_pay_alt": {
      "account_number": "41111111XXXX1111"
    },
  ...
}

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

object
amount
обязательный
 bigInteger
Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро).
ip
 string
IP-адрес покупателя.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
apple_pay_alt
object
Секция информации о покупателе.
first_name
 string
Имя покупателя.
last_name
 string
Фамилия покупателя.
email
 string
Адрес электронной почты покупателя.
country
 string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, DE.
object
Секция, содержащая дополнительную информацию о платеже.
object
Секция дополнительной информации о покупателе.
id
обязательный
 string
Идентификатор покупателя в системе торговца.
Пример запроса 
{
  "request": {
    "amount": 200,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://your_return_url.com",
    "method": {
      "type": "apple_pay_alt"
    },
    "additional_data": {
      "customer": {
        "id": "12435"
      }
    }
  }
}
Ответ

Отправьте покупателя на URL, который формируется следующим образом: URL из параметра form.action + ? + значение параметра form.fields.name + = + значение параметра form.fields.value.

Например: https://example.com/url-for-redirect?data=eyJpZCI6MjE4MTI4ODU2MSwiY29udHJvbCI6IjVlZDkyODBjZDFhNzRkZmVmZDRhOWNhNDQ3YmM3ZDFhIn0=.

Пример ответа 
{
    "transaction": {
        "uid": "7f207381-a4dd-470e-8aca-ae4e5269f034",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "test",
        "created_at": "2024-09-04T14:20:56Z",
        "updated_at": "2024-09-04T14:20:57Z",
        "method_type": "apple_pay_alt",
        "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/7f207381-a4dd-470e-8aca-ae4e5269f034/d969286649a10333ddaf1547b803547444cd66af9465d97d5ff526d5fdde6f8f",
        "payment": {
            "status": "pending",
            "gateway_id": 4417,
            "ref_id": "2181300649",
            "message": "Transaction was initialized."
        },
        "apple_pay_alt": {
            "type": "apple_pay_alt"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "tracking_id": "your_uniq_number21212",
        "test": false,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://example.com/url-for-redirect",
            "method": "GET",
            "fields": [
                {
                    "name": "data",
                    "value": "eyJpZCI6MjE4MTMwMDY0OSwiY29udHJvbCI6ImM0OTk1NzVlZjk2NmU5OTllY2YyNDM5MmJiZWNjOWQ3In0="
                }
            ]
        }
    }
}

Вариант интеграции SS

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PacoPay Service Provider.
  3. PacoPay Service Provider присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PacoPay Service Provider.
  5. Покупатель завершает оплату.
  6. PacoPay Service Provider отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PacoPay Service Provider с помощью запроса получения статуса транзакции. Если транзакция успешна, уведомление или ответ на запрос статуса могут содержать параметр apple_pay_alt.account_number с маской карты.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
apple_pay_alt
Пример запроса 
{
  "request": {
    "amount": 444,
    "currency": "EUR",
    "description": "test description",
    "test": false,
    "tracking_id": "your_uniq_number21212",
    "ip": "127.0.0.1",    
    "return_url": "https://your-success.url",
    "method": {
      "type": "apple_pay_alt"
    }
  }
}
Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа 
{
  "transaction": {
    "uid": "cd7f3e9e-3484-407b-a880-b70d9906a0e3",
    "type": "payment",
    "status": "pending",
    "amount": 444,
    "currency": "EUR",
    "description": "test description",
    "created_at": "2025-07-01T07:21:34Z",
    "updated_at": "2025-07-01T07:21:34Z",
    "method_type": "apple_pay_alt",
    "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/cd7f3e9e-3484-407b-a880-b70d9906a0e3/2c5248b0087d16eb66dfca89c2f8f22f3d762660576096dcab8d956133ac9bf4?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 5527,
      "ref_id": "951599511",
      "message": "Invoice is created successfully, waiting for a payment",
      "bank_code": 31,
      "rrn": 8888,
      "auth_code": 9999
    },
    "apple_pay_alt": {
      "type": "apple_pay_alt"
    },
    "customer": {
      "email": null,
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "version": 1,
    "message": "Invoice is created successfully, waiting for a payment",
    "tracking_id": "your_uniq_number21212",
    "test": false,
    "language": "en",
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "payment-link",
      "fields": [],
      "method": "GET"
    }
  }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата должна быть равна сумме соответствующей транзакции оплаты.