Banking & karty

API zarządzania wydatkami

Włącz konto korporacyjne, saldo i limit, porty, emisję kart, zakupy, centra kosztów, faktury i analizy wydatków przez API publiczny IOPAY.

Baza URLhttps://api.iopay.com.br/api/v1/baas
AutentykęBearer token
ObszarBanking · karty korporacyjne

Od rachunku korporacyjnego do przechowywania wydatków.

API organizuje działalność gospodarczą w oddzielnych zasadach, prowadząc rachunek, portfele, karty, zakupy, faktury i analizy w ramach jednej umowy publicznej.

Banking

Licz, saldo i limit.

Sprawdź status konta, dostępność i zwróć się o limity.

Wydawanie kart

- Noszący karty.

Stwórz portfele, wydaj karty wirtualne lub fizyczne i wdrażaj zasady użytkowania.

Zarządzanie

Zakupy, faktury i analizy.

Śledź wydatki, centra kosztów, faktury i grupy analityczne.

Status konta przedsiębiorstwa

Aktywacja nie jest wykonywana przez publiczny API. Wykres GET /corporate/cards/account pozostaje dostępny w dowolnym państwie, aby zapoznać się z aktualnym stanem postępowania.

01inactive

Jeszcze niezawiadomiony aktywacja.

02waiting_contract_assignment

Aktualizowana umowa musi zostać zaakceptowana w Rachunku IOPAY.

03pending

Wniosek analizowany przez zespół IOPAY.

04active

Dostępne operacje API.

Ativação. Nie ma żadnego publicznego punktu końcowego, aby zwrócić się o aktywację lub zaakceptować umowę. Wypisanie następuje za pośrednictwem rachunku IOPAY. Status suspended wskazuje, że nie ma on dostępnego do rachunku.

Wpływ podstawowy

01 · LiczbaSprawdź status.

Potwierdź, że skargę active.

02 · Przewoźnik- Wykonuj ten drukarek.

Definiuj tożsamość, limit, zakres i centrum kosztów.

03 · KartyWydaj kartę.

Wybór typu, ograniczenia i ograniczenia wprowadzania do przedsiębiorstwa, gdzie ma zastosowanie.

04 · Operacja- Spójrz na wydatki.

Korzystaj z zakupów, faktur, centrum kosztów i analityki.

Tworzenie porty

POST /corporate/cards/holders
{
  "name": "NOME HOLDER",
  "tax_id": "12345678909",
  "amount": 1000,
  "interval": "month",
  "center_cost": "MeuCenterCost"
}

Tworzenie karty

POST /corporate/cards
{
  "holder_id": "{{holder_id}}",
  "name": "Google Ads",
  "limit": 100000,
  "interval": "month",
  "type": "virtual",
  "merchant": "GOOGLE"
}
- Zatrudnienie handlowe. merchant określa ograniczenie miejsca zamieszkania, a nie nazwę karty. Używaj name jako wewnętrzna identyfikacja. Nie wprowadzać merchant lub wysyłanie null nie określa ograniczeń dla tej dziedziny.

Zasoby i punkty końcowe

ObszarOperacjeGłówna droga
Liczy sięStatus, saldo, limit i ładowanie./corporate/cards/account · /balance · /recharge
Posiadacze kartLista, przegląd, tworzenie, aktualizacja i odwołanie./corporate/cards/holders
Karty na nosicielaSprawdzanie kart i zakupy od posiadacza./holders/{holder_id}/cards · /purchases
KartyWyliczanie, przeglądanie, tworzenie, aktualizacja i przeglądanie danych wrażliwych./corporate/cards · /{card_id}/secrets
ZakupyOgólny wykaz i przez kartę/przewoźnik./corporate/cards/purchases
Centrum kosztówGrupa wydatków i szczegóły centrum./corporate/cards/cost-centers
WyciągiWyliczyć, zmienić wynagrodzenie i wygenerować wypłatę./corporate/cards/invoices
AnalitykaZresztą i grupami wydatków./corporate/cards/analytics

Ograniczenia, podmioty i centra kosztów

Posiadacz karty

Rzecz w tym, że jest to ograniczenie.

Właściciel otrzymuje amount i przerwy day, week lub month.

Karta

Wirtualne lub fizyczne.

Przywiąż kartę do nosiciela i wyznacz limit, interval i ograniczenie handlowe, gdy to konieczne.

Centrum kosztów

Kontext do operacji.

Grupa wydatków i sprawdź zakupy, kwoty i cashback według centrum kosztów.

Zasoby i strona internetowa

Suksesful Answers Identify the Resource by resource. Listowanie używa standardowego opakowania z items, limit, total, offset, has_more i query_count.

Wykres listy
{
  "resource": "list",
  "sort": "time-descending",
  "items": [],
  "limit": 100,
  "total": 0,
  "offset": 0,
  "has_more": false,
  "query_count": 0
}
Paginação. limit i offset są wspierane w listach. Standardowy limit to 100 i maksymalny to 1000. W ramach zgodnych konsultacji, ?refresh=true aktualizuje bazę IOPAY z najnowszymi danymi banku emisji przed odpowiedzią.

Wnioski z zakresu rozliczeń

Wyciągi

Wynagrodzenie i wypłata.

Wypełniaj faktury, ustawiaj dzień zapadalności od 1 do 28 i zarządzaj danymi płatniczymi, które mogą obejmować: brcode i link.

Analityka

Konsyndurowane wydatki.

Sprawdź całkowite wydatki, ilość zakupów, cashback i grupy według kategorii, centrum kosztów, przewoźnik i miesięczne zmiany.

Dane z karty

Wykres GET /corporate/cards/{card_id}/secrets zwraca PAN, CVV, ważność i TTL, gdy jest to konieczne do operacji.

- Wykorzystanie w czasie. Nie przechowuj ani nie zapisuj odpowiedzi tego punktu końcowego. Sam zbiór zaleca, aby te dane były dostępne tylko wtedy, gdy jest to konieczne.

Publiczna kolekcja

W kolekcji znajdują się 23 udokumentowanych punktów końcowych, przykłady sukcesu i błędu dla istotnych przepływów konta, ładunków, portów i operacji.