Setup & autentimine

Juurdepääsutunnused

Kuidas hankida, säilitada ja rakendada IOPAY veebimaksete integratsioonides kasutatavaid tunnuseid.

VäljadEmail · IO Seller ID · Secret · Antifraud ID
Kus luuaMüük → Veebimaksed
AutentimineBearer token

Ülevaade

Tunnused võimaldavad veebimaksete integratsioone. Secret peab jääma backendi ning eemale hoidlatest ja avalikest liidestest.

Turvalisus

Secret on konfidentsiaalne.

Secret peab olema ainult backendis ja sobivates saladuste hoidlates.

Roteerimine

Uuesti loomine muudab eelmise võtme kehtetuks.

Planeeri Secreti vahetus, et vältida katkestusi roteerimise ajal.

Kuidas hankida

  1. Ava IO digikonto.
  2. Mine jaotisse Müük → Veebimaksed.
  3. Luba veebimaksed, kui see on registreerimisel kohaldatav.
  4. Loo tunnused ja salvesta väärtused turvalisse keskkonda.
  5. Seadista makseviisid ja lõpuks checkouti integratsioonivalikud.
Secret. Secret kuvatakse ainult loomise hetkel. Kui pead looma uue, muutub eelmine võti kehtetuks.

Väljad

VõtiFunktsioonMärkus
emailIntegratsiooniga seotud tuvastus.Saadetakse autentimisel.
io_seller_idSelleri/konto identifikaator IOPAY kontekstis.Saadetakse autentimisel ja kasutatakse toimingu kontekstis.
secretAutentimise saladus.Saadetakse autentimisel. Ära kunagi avalikusta seda frontendis.
antifraud_idPettusetõrje paketiga seotud identifikaator.Pole vajalik, kui kontol pole aktiivset pettusetõrje paketti.

Autendi integratsioon

Saada email, secret ja io_seller_id, et saada järgmistes API-kutsetes kasutatav token.

POST /auth/login
curl --request POST \
  --url https://api.iopay.com.br/api/auth/login \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "your_email",
    "secret": "your_secret",
    "io_seller_id": "<IO_SELLER_ID>"
  }'

Vastus

Access token
{
  "access_token": "<ACCESS_TOKEN>",
  "token_type": "bearer",
  "token_scope": "transaction",
  "expires_in": 3600
}
Bearer Token. Kasuta tagastatud access_token-it kujul Authorization: Bearer your_token järgmistes API-kutsetes.

Seadistus

Pärast tunnuseid võib veebimaksete seadistus hõlmata krediiti, Pixi ja boletosid, osamaksete arvu ning checkouti parameetreid.

Webhook

Teavituse URL.

Sisesta HTTPS URL toimingu teavituste vastuvõtmiseks.

Domeen

HTTPS-piirang.

Piira integratsioonid oodatud domeeniga, kui seadistus seda nõuab.

Branding

Logo URL.

Seo HTTP/HTTPS logo URL ühilduvate integratsioonidega.

Head tavad

  • Hoia saladusi keskkonnamuutujates või secret manageris.
  • Ära saada Secretit brauseris käivitatavas JavaScriptis.
  • Eralda sandbox/testid ja tootmine.
  • Planeeri võtmete roteerimine töötlust katkestamata.
  • Registreeri, kes muutis sisekeskkondades tunnuseid.