Yritystilistä kulujen seurantaan.
API jäsentää yritystoiminnan erillisiksi resursseiksi ja pitää tilin, kortinhaltijat, kortit, ostot, laskut ja analyysit saman julkisen sopimuksen sisällä.
Tili, saldo ja limiitti.
Tarkista tilin tila ja saatavuus ja pyydä limiitin latauksia.
Kortinhaltijat ja kortit.
Luo kortinhaltijoita, myönnä virtuaalisia tai fyysisiä kortteja ja sovella käyttösääntöjä.
Ostot, laskut ja analyysit.
Seuraa kuluja, kustannuspaikkoja, laskuja ja analyyttisiä ryhmittelyjä.
Yritystilin tila
Aktivointia ei tehdä julkisen API:n kautta. Päätepiste GET /corporate/cards/account on käytettävissä kaikissa tiloissa resurssin nykytilan tarkistamiseen.
Aktivointia ei ole vielä pyydetty.
Päivitetty sopimus on hyväksyttävä IOPAY-tilillä.
Pyyntö IOPAY-tiimin arvioitavana.
API-toiminnot käytettävissä.
suspended tarkoittaa, että resurssi ei ole tilin käytettävissä.Perusvirta
Varmista, että resurssi on active.
Määritä identiteetti, limiitti, aikaväli ja kustannuspaikka.
Valitse tyyppi, limiitti ja tarvittaessa liikerajoitus.
Käytä ostoja, laskuja, kustannuspaikkoja ja analytiikkaa.
Luo kortinhaltija
{
"name": "NOME HOLDER",
"tax_id": "12345678909",
"amount": 1000,
"interval": "month",
"center_cost": "MeuCenterCost"
}Luo kortti
{
"holder_id": "{{holder_id}}",
"name": "Google Ads",
"limit": 100000,
"interval": "month",
"type": "virtual",
"merchant": "GOOGLE"
}merchant määrittää liikerajoituksen, ei kortin nimeä. Käytä name-kenttää sisäisenä tunnisteena. Jos merchant jätetään pois tai lähetetään null, kenttä ei aseta rajoitusta.Resurssit ja päätepisteet
| Alue | Toiminnot | Pääreitti |
|---|---|---|
| Tili | Tila, saldo, limiitti ja lataus. | /corporate/cards/account · /balance · /recharge |
| Kortinhaltijat | Listaa, hae, luo, päivitä ja peruuta. | /corporate/cards/holders |
| Kortit kortinhaltijoittain | Hae holderin kortit ja ostot. | /holders/{holder_id}/cards · /purchases |
| Kortit | Listaa, hae, luo, päivitä ja hae arkaluonteiset tiedot. | /corporate/cards · /{card_id}/secrets |
| Ostot | Yleislistaus sekä kortin/kortinhaltijan mukaan. | /corporate/cards/purchases |
| Kustannuspaikat | Ryhmitellyt kulut ja kustannuspaikan tiedot. | /corporate/cards/cost-centers |
| Laskut | Listaa, muuta eräpäivää ja luo maksu. | /corporate/cards/invoices |
| Analytiikka | Kulujen yhteenveto ja ryhmittelyt. | /corporate/cards/analytics |
Limiitit, kortinhaltijat ja kustannuspaikat
Limiitti säännön mukaan.
Holder saa amount-arvon ja aikavälin day, week tai month.
Virtuaalinen tai fyysinen.
Liitä kortti kortinhaltijaan ja määritä tarvittaessa limiitti, aikaväli ja liikerajoitus.
Kontekstia toimintaan.
Ryhmittele kulut ja tarkastele ostoja, summia ja cashbackia kustannuspaikoittain.
Resurssit ja sivutus
Onnistuneet vastaukset tunnistavat resurssin kentällä resource. Listaukset käyttävät vakioitua käärettä, jossa on items, limit, total, offset, has_more ja query_count.
{
"resource": "list",
"sort": "time-descending",
"items": [],
"limit": 100,
"total": 0,
"offset": 0,
"has_more": false,
"query_count": 0
}limit- ja offset-parametreja. Oletusraja on 100 ja enimmäismäärä 1000. Yhteensopivissa kyselyissä ?refresh=true päivittää IOPAYn tietokannan myöntävän pankin uusimmilla tiedoilla ennen vastausta.Laskut ja kuluanalyysit
Eräpäivä ja maksu.
Listaa laskut, aseta eräpäivä väliltä 1–28 ja luo laskun maksutiedot, jotka voivat sisältää brcode- ja link-tiedot.
Kootut kulut.
Tarkastele kokonaiskulutusta, ostojen määrää, cashbackia ja ryhmittelyjä kategorian, kustannuspaikan, kortinhaltijan ja kuukausikehityksen mukaan.
Kortin tiedot
Päätepiste GET /corporate/cards/{card_id}/secrets palauttaa PAN:n, CVV:n, voimassaolon ja TTL:n, kun toiminta sitä edellyttää.
Julkinen collection
Collection kokoaa 23 dokumentoitua päätepistettä sekä onnistumis- ja virhe-esimerkit tilin, latauksen, kortinhaltijoiden ja toiminnan keskeisiin virtoihin.