Ettevõtte kontost kulude jälgimiseni.
API korraldab ettevõtte toimingud eraldi ressurssideks, hoides konto, kaardiomanikud, kaardid, ostud, arved ja analüüsid sama avaliku lepingu sees.
Konto, saldo ja limiit.
Vaata konto staatust ja kättesaadavust ning taotle limiidi laadimist.
Kaardiomanikud ja kaardid.
Loo kaardiomanikke, väljasta virtuaalseid või füüsilisi kaarte ja rakenda kasutusreegleid.
Ostud, arved ja analüüsid.
Jälgi kulusid, kulukeskusi, arveid ja analüütilisi grupeeringuid.
Ettevõtte konto staatus
Aktiveerimist ei tehta avaliku API kaudu. Lõpp-punkt GET /corporate/cards/account jääb igas olekus kättesaadavaks, et vaadata ressursi praegust olukorda.
Aktiveerimist pole veel taotletud.
Uuendatud leping tuleb IOPAY kontol aktsepteerida.
Taotlus IOPAY meeskonna analüüsis.
API toimingud saadaval.
suspended näitab, et ressurss pole kontole kättesaadav.Põhivoog
Veendu, et ressurss on active.
Määra identiteet, limiit, intervall ja kulukeskus.
Vali tüüp, limiit ja vajaduse korral kaupmehe piirang.
Kasuta oste, arveid, kulukeskusi ja analüütikat.
Loo kaardiomanik
{
"name": "NOME HOLDER",
"tax_id": "12345678909",
"amount": 1000,
"interval": "month",
"center_cost": "MeuCenterCost"
}Loo kaart
{
"holder_id": "{{holder_id}}",
"name": "Google Ads",
"limit": 100000,
"interval": "month",
"type": "virtual",
"merchant": "GOOGLE"
}merchant määrab kaupmehe piirangu, mitte kaardi nime. Kasuta name sisemise tuvastusena. merchant ära jätmine või null saatmine ei määra selle välja kaudu piirangut.Ressursid ja lõpp-punktid
| Valdkond | Toimingud | Põhimarsruut |
|---|---|---|
| Konto | Staatus, saldo, limiit ja laadimine. | /corporate/cards/account · /balance · /recharge |
| Kaardiomanikud | Loetle, päri, loo, uuenda ja tühista. | /corporate/cards/holders |
| Kaardid kaardiomaniku kaupa | Päri holderi kaardid ja ostud. | /holders/{holder_id}/cards · /purchases |
| Kaardid | Loetle, päri, loo, uuenda ja päri tundlikud andmed. | /corporate/cards · /{card_id}/secrets |
| Ostud | Üldloend ning kaardi/kaardiomaniku kaupa. | /corporate/cards/purchases |
| Kulukeskused | Grupeeritud kulud ja kulukeskuse üksikasjad. | /corporate/cards/cost-centers |
| Arved | Loetle, muuda tähtaega ja loo makse. | /corporate/cards/invoices |
| Analüütika | Kulude kokkuvõte ja grupeeringud. | /corporate/cards/analytics |
Limiidid, kaardiomanikud ja kulukeskused
Limiit reegli järgi.
Holder saab amount ja intervalli day, week või month.
Virtuaalne või füüsiline.
Seo kaart kaardiomanikuga ning määra vajaduse korral limiit, intervall ja kaupmehe piirang.
Kontekst toimingule.
Grupeeri kulud ning vaata oste, summasid ja cashbacki kulukeskuse kaupa.
Ressursid ja lehekülgedeks jagamine
Edukad vastused tuvastavad ressursi välja resource kaudu. Loendid kasutavad standardset ümbrist väljadega 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. Vaikimisi limiit on 100 ja maksimum 1000. Ühilduvates päringutes uuendab ?refresh=true enne vastust IOPAY andmebaasi väljastava panga uusimate andmetega.Arved ja kuluanalüüsid
Tähtaeg ja makse.
Loetle arved, määra tähtpäev vahemikus 1 kuni 28 ja loo arve makseandmed, mis võivad sisaldada brcode ja link välju.
Koondatud kulud.
Vaata kogukulu, ostude arvu, cashbacki ja grupeeringuid kategooria, kulukeskuse, kaardiomaniku ja kuise arengu järgi.
Kaardi andmed
Lõpp-punkt GET /corporate/cards/{card_id}/secrets tagastab PAN-i, CVV, kehtivusaja ja TTL-i, kui see on toiminguks vajalik.
Avalik kollektsioon
Kollektsioon koondab 23 dokumenteeritud lõpp-punkti ning õnnestumise ja vea näited konto, laadimise, kaardiomanike ja toimingute oluliste voogude jaoks.