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

Банковский перевод

Вариант интеграции PY (Уругвай)

Оплата

Info

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

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

  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 с помощью запроса получения статуса транзакции.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращён покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_uruguay
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 500,
        "currency": "UYU",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "method": {
            "type": "bank_transfer_uruguay"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "43880dad-3d8e-4169-90b0-6dbaa6b3c42e",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "UYU",
        "description": "description",
        "created_at": "2026-01-27T12:12:26Z",
        "updated_at": "2026-01-27T12:12:29Z",
        "method_type": "bank_transfer_uruguay",
        "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/43880dad-3d8e-4169-90b0-6dbaa6b3c42e/1173523e2c055b7cdac62b784efa75380403870342a37d958316c0fee531ff25",
        "payment": {
            "status": "pending",
            "gateway_id": 6065,
            "ref_id": "PIU26Y01U27U12Y12U28705",
            "message": "Transaction was initialized."
        },
        "bank_transfer_uruguay": {
            "type": "bank_transfer_uruguay",
            "use_pending_page": true
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 4,
        "message": "Transaction was initialized.",
        "test": true,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующими данными:
object
object
Секция параметров способа выплаты.
type
обязательный
 string
bank_transfer_uruguay
account_number
обязательный
 string
Идентификатор счета для выплаты.
bank_code
обязательный
 string
Код банка получателя выплаты (из ответа на запрос доступных банков).
bank_name
обязательный
 string
Название банка получателя выплаты (из ответа на запрос доступных банков).
object
Секция информации о получателе выплаты.
first_name
обязательный
 string (60)
Имя получателя выплаты.
last_name
обязательный
 string (60)
Фамилия получателя выплаты.
state
обязательный
 string (40)
Штат, регион, департамент получателя выплаты.
city
обязательный
 string (120)
Город получателя выплаты.
address
обязательный
 string (510)
Адрес получателя выплаты. Используйте формат согласно примеру: Avenida 18 de Julio, Apto 8203.
zip
обязательный
 string (40)
Почтовый индекс получателя выплаты.
email
обязательный
 string
Адрес электронной почты получателя выплаты.
phone
обязательный
 string (8)
Номер телефона получателя выплаты без кода страны.
id_number
обязательный
 string
Номер идентификационного документа получателя выплаты.
object
Секция дополнительной информации.
object
Секция дополнительной информации о получателе выплаты.
id_type
обязательный
 string
Тип документа получателя выплаты.
Пример запроса 
{
  "request": {
    "amount": 100,
    "currency": "UYU",
    "description": "description",
    "test": false,        
    "tracking_id": "123",    
    "language": "en",
    "notification_url": "https://your-notification.url",
    "return_url": "https://your-success.url",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": "Mid",     
      "city": "Montevideo",
      "zip": "11100",
      "address": "Av. 18 de Julio 1234, Apto 8203",
      "phone": "091234567",      
      "state": "Montevideo",
      "email": "[email protected]",
      "id_number": "1.234.567-2"
    },
    "method": {
      "type": "bank_transfer_uruguay",
      "bank_code": "SBIN0030526",
      "bank_name": "STATE BANK OF UY",
      "account_number": "224103907"
    },
    "additional_data": {
      "customer": {
        "id_type": "Cedula Uruguaya"
      }
    },
  }
}
Ответ
Пример ответа 
{
  "transaction": {
    "uid": "32c0c5e5-57eb-4892-97d7-f5dd9d43b6cc",
    "type": "payout",
    "status": "pending",
    "amount": 100,
    "currency": "UYU",
    "description": "description",
    "created_at": "2026-04-03T11:47:17Z",
    "updated_at": "2026-04-03T11:47:20Z",
    "manually_corrected_at": null,
    "method_type": "bank_transfer_uruguay",
    "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/32c0c5e5-57eb-4892-97d7-f5dd9d43b6cc/d32db9a12dc438701688401aed19036a1792bcf7fb9b82edc3e6e414cf51d3e8?language=en",
    "payout": {
      "status": "pending",
      "gateway_id": 6267,
      "ref_id": "POU26S04D03I11N47R20087",
      "message": "Transaction was initialized."
    },
    "bank_transfer_uruguay": {
      "type": "bank_transfer_uruguay"
    },
    "customer": {
      "email": "[email protected]",
      "ip": null
    },
    "version": 1,
    "message": "Transaction was initialized.",
    "tracking_id": "123",
    "test": false,
    "language": "en",
    "billing_address": {
      "zip": "11100",
      "city": "Montevideo",
      "email": "[email protected]",
      "phone": "091234567",
      "state": "Montevideo",
      "id_number": "1.234.567-2",
      "address": "Av. 18 de Julio 1234, Apto 8203",   
      "last_name": "Doe",
      "first_name": "John",
      "middle_name": "Mid"
    },
    "additional_data": {
      "customer": {
        "id_type": "Cedula Uruguaya"
      },
      "payment_method": {
        "type": "alternative"
      }
    },
    "smart_routing_verification": {
      "status": "successful"
    }
  }
}

Запрос списка поддерживаемых банков

Запрос

Для получения списка поддерживаемых банков отправьте GET запрос на https://api.paco-pay.com/beyag/gateways/{gateway_id}/bank_list, где gateway_id - это идентификатор платежного шлюза, который активирован для метода bank_transfer_uruguay. Чтобы получить идентификатор шлюза, обратитесь в Службу поддержки или к вашему менеджеру.

Ответ

В ответ на запрос списка банков система возвращает список доступных банков для выплаты.

Используйте полученные значения bank_name и bank_code для одноименных параметров в запросе на выплату средств.

Пример ответа 
{
  "response": {
    "list": [
      {
        "bank_code": "SBIN0017215",
        "bank_name": "BANK 1"
      },
      {
        "bank_code": "HDFC0008967",
        "bank_name": "BANK 2"
      }
    ]
  }
}

Вариант интеграции PY (Аргентина)

Оплата

Info

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

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PacoPay Service Provider.
  3. PacoPay Service Provider возвращает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Торговец перенаправляет покупателя на страницу, указанную в параметре form.action из ответа PacoPay Service Provider.
  5. Покупатель выбирает один из доступных методов оплаты и завершает оплату. Доступные методы: Transferencia 3.0 (QR) и DEBIN (Instant Debit).
  6. PacoPay Service Provider отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PacoPay Service Provider с помощью запроса получения статуса транзакции. После финализации транзакции в автоматическом уведомлении или в ответе на запрос статуса параметр method_type может иметь значение transferencia_3_0 или debin в зависимости от метода оплаты, выбранного покупателем. Ответ на запрос статуса может содержать обновлённое значение method_type также при статусе транзакции pending, если до момента отправки запроса статуса покупатель уже выбрал метод оплаты на платёжной странице.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращён покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_argentina
Пример запроса 
{
    "request": {
        "test": false,
        "amount": 500,
        "currency": "ARS",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "method": {
            "type": "bank_transfer_argentina"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "49d8634c-e6bf-4ca4-beb9-b805a14df4be",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "ARS",
        "description": "description",
        "created_at": "2026-08-20T15:24:12Z",
        "updated_at": "2026-08-20T15:24:13Z",
        "method_type": "bank_transfer_argentina",
        "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/49d8634c-e6bf-4ca4-beb9-b805a14df4be/8c386e7ed5ec72d0e16979f77af3081c14873059e00b5d2b155cb1ade631c5f3?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 7108,
            "ref_id": "76735489188507443121",
            "message": "Transaction was initialized."
        },
        "bank_transfer_argentina": {
            "type": "bank_transfer_argentina",
            "use_pending_page": true
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 3,
        "message": "Transaction was initialized.",
        "tracking_id": "123",
        "test": false,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}
Автоматическое уведомление

После финализации транзакции в автоматическом уведомлении или в ответе на запрос статуса параметр method_type может иметь значение transferencia_3_0 или debin в зависимости от метода оплаты, выбранного покупателем.

Пример автоматического уведомления 
{
  "transaction": {
    "uid": "3bba43a0-1f67-4537-93f9-d7a6c1c3b7a2",
    "type": "payment",
    "status": "successful",
    "amount": 100,
    "currency": "ARS",
    "description": "description",
    "created_at": "2026-08-20T07:47:39Z",
    "updated_at": "2026-08-20T07:47:53Z",
    "method_type": "transferencia_3_0",
    "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/3bba43a0-1f67-4537-93f9-d7a6c1c3b7a2/c8b8e3215c2b566dbfa9324e8a0d6b530abf350d8d2cf62a12a56fbcabd433cd?language=en",
    "payment": {
      "status": "successful",
      "gateway_id": 6267,
      "ref_id": "PIA26R08S05A18R02S22442",
      "message": "Transaction was successfully processed."
    },
    "transferencia_3_0": {
      "type": "transferencia_3_0",
      "use_pending_page": true
    },
    "manually_corrected_at": null,
    "version": 5,
    "message": "Transaction was successfully processed.",
    "tracking_id": "123",
    "test": false,
    "language": "en",
    "paid_at": "2026-08-20T07:47:53Z",
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "smart_routing_verification": {
      "status": "skipped"
    },
    "gateway": {
      "iframe": true
    }
  }
}