Бразилия

Это схема host-to-host: вы получаете QR-ссылку PIX напрямую из API и отображаете её в собственном интерфейсе.

POST /v1/orders/{orderId}/h2h/pix

curl -X POST "https://api.1capital.capital/v1/orders/{orderId}/h2h/pix" \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: YOUR_API_TOKEN"

{
  "qrLink": "https://pix.com.br/..."
}

Плательщик перенаправляется на paymentLink и вводит данные карты на платёжной странице. Результат обычно известен сразу; финальный статус приходит webhook-уведомлением.

Документ, email и полный адрес плательщика передаются в объекте customer. Банк проверяет карточный платёж по данным плательщика и без адреса отклоняет его — даже для цифровых товаров. Заказ с недостающими полями, с документом, не прошедшим проверку контрольных цифр, или со штатом не в виде двухбуквенного кода отклоняется с 400.

Поля объекта customer

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

{
  "purpose": "Payment for order #1234",
  "amount": "150",
  "currency": "BRL",
  "externalId": "external_id",
  "externalUserId": "external_user_id",
  "successUrl": "https://example.com/success",
  "failUrl": "https://example.com/fail",
  "callbackUrl": "https://example.com/webhooks/payments",
  "isFeeOnUser": false,
  "customer": {
    "firstName": "Ana",
    "lastName": "Souza",
    "email": "ana.souza@example.com",
    "document": "12345678909",
    "phone": "11999998888",
    "postcode": "01310-100",
    "street": "Av. Paulista",
    "addressNumber": "1578",
    "addressComplement": "Apto 12",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP"
  }
}

Плательщик перенаправляется на paymentLink. Платёжная страница показывает boleto: его номер (linha digitável) с кнопкой копирования, ссылку на PDF и PIX того же boleto как более быстрый способ.

Boleto регистрируется в банке на имя плательщика, поэтому в объекте customer обязательны полные данные плательщика: действительный документ, контакты и полный адрес. Заказ с недостающими или некорректными полями отклоняется с 400.

Поля объекта customer

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

{
  "purpose": "Payment for order #1234",
  "amount": "150",
  "currency": "BRL",
  "externalId": "external_id",
  "externalUserId": "external_user_id",
  "successUrl": "https://example.com/success",
  "failUrl": "https://example.com/fail",
  "callbackUrl": "https://example.com/webhooks/payments",
  "isFeeOnUser": false,
  "customer": {
    "firstName": "Maria",
    "lastName": "Santos",
    "document": "12345678909",
    "email": "maria.santos@example.com",
    "phone": "11999998888",
    "postcode": "01310-100",
    "street": "Av. Paulista",
    "addressNumber": "1578",
    "addressComplement": "Apto 12",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP"
  }
}

Срок оплаты и подтверждение

• Срок оплаты boleto — 3 календарных дня после выпуска, по времени Бразилиа. Заказ остаётся в PENDING до конца дня срока оплаты, затем переходит в EXPIRED.
• Оплаченный boleto банк подтверждает примерно за один рабочий день. Оплата по PIX этого boleto подтверждается за секунды.
• Банки принимают boleto ещё некоторое время после срока оплаты. Когда такая оплата подтверждается, истёкший заказ переходит в COMPLETED, и вы получаете webhook-уведомление.