Yleiskatsaus
Yleiskatsaus
Tunnisteet mahdollistavat verkkomaksuintegraatiot. Secretin on pysyttävä backendissä ja poissa repositorioista tai julkisista käyttöliittymistä.
Secret on luottamuksellinen.
Secretin tulee olla vain backendissä ja asianmukaisissa salaisuusholveissa.
Uudelleenluonti mitätöi edellisen avaimen.
Suunnittele Secretin vaihto, jotta kierrätys ei aiheuta katkoja.
Miten hankitaan
Miten hankitaan
- Avaa IO-digitili.
- Siirry kohtaan Myynti → Verkkomaksut.
- Ota verkkomaksut käyttöön, jos se koskee rekisteröintiä.
- Luo tunnisteet ja säilytä arvot turvallisessa ympäristössä.
- Määritä maksutavat ja lopuksi checkoutin integraatioasetukset.
Secret. Secret näytetään vain luontihetkellä. Jos luot uuden, edellinen avain mitätöidään.
Integraation tunnisteet
Kentät
| Avain | Tehtävä | Huomio |
|---|---|---|
email | Integraatioon liitetty tunniste. | Lähetetään tunnistautumisessa. |
io_seller_id | Sellerin/tilin tunniste IOPAY-kontekstissa. | Lähetetään tunnistautumisessa ja käytetään toiminnan kontekstissa. |
secret | Tunnistautumisen salaisuus. | Lähetetään tunnistautumisessa. Älä koskaan paljasta sitä frontendissä. |
antifraud_id | Petostentorjuntasuunnitelmaan liittyvä tunniste. | Ei tarvita, jos tilillä ei ole aktiivista petostentorjuntasuunnitelmaa. |
Tunnistaudu integraatioon
Lähetä email, secret ja io_seller_id saadaksesi seuraavissa API-kutsuissa käytettävän tokenin.
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>"
}'Vastaus
Access token
{
"access_token": "<ACCESS_TOKEN>",
"token_type": "bearer",
"token_scope": "transaction",
"expires_in": 3600
}Bearer Token. Käytä palautettua
access_token:ia muodossa Authorization: Bearer your_token seuraavissa API-kutsuissa.Lisämääritykset
Määritys
Tunnisteiden jälkeen verkkomaksujen määritys voi sisältää luoton, Pixin ja boletot, erien määrän ja checkoutin parametrit.
Ilmoitus-URL.
Anna HTTPS-URL toiminnan ilmoitusten vastaanottamiseen.
HTTPS-rajoitus.
Rajoita integraatiot odotettuun verkkotunnukseen, kun määritys sitä edellyttää.
Logon URL.
Liitä HTTP/HTTPS-logon URL yhteensopiviin integraatioihin.
Hyvät käytännöt
Hyvät käytännöt
- Säilytä salaisuudet ympäristömuuttujissa tai secret managereissa.
- Älä lähetä Secretiä selaimessa suoritettavassa JavaScriptissä.
- Erottele sandbox/testit ja tuotanto.
- Suunnittele avainten kierrätys keskeyttämättä käsittelyä.
- Kirjaa, kuka on muuttanut tunnisteita sisäisissä ympäristöissä.