DocsUKK ja vianmääritys
Yleisiä kysymyksiä ja vianmääritysvinkkejä
1. Saan "Unauthorized"-virheen
Tämä tarkoittaa yleensä, että lähetät virheellisen tai väärin kirjoitetun API-avaimen. Tarkista, että avaimesi on oikein ja että se on muotoiltu oikein Authorization-otsakkeessa.
Esimerkki epäonnistuneesta todennusvastauksesta:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Varmista, että lisäät kaksoispisteen API-avaimesi perään käyttäessäsi Basic Auth -todennusta (esim. YOUR_API_KEY:). Kaksoispiste erottaa käyttäjänimen tyhjästä salasanasta.
2. Saan "Unsupported payment method" -virheen
Jokainen maksutapa on aktivoitava tilillesi ennen kuin sitä voi käyttää. Jos yrität käyttää ei-aktiivista tapaa, API palauttaa 400 Bad Request:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Ota yhteyttä Cost+-tilinhallintaasi tai ota maksutapa käyttöön hallintaportaalissa kohdassa Settings > Payment Methods.
3. Mitä testikorttinumeroita voin käyttää?
Katso Integraation testaus -sivu täydellisestä luettelosta testikorttinumeroita, mukaan lukien kortit, jotka simuloivat onnistuneita ja epäonnistuneita tapahtumia.
4. Miten webhook-uudelleenyritykset käsitellään?
Jos webhook-päätepisteesi ei vastaa 2xx-tilakoodilla, Cost+ yrittää lähetystä uudelleen:
- Enintään 10 uudelleenyritystä, 2 minuutin välein.
- Ensimmäisen yrityksen aikakatkaisu on 4 sekuntia.
- Myöhempien yritysten aikakatkaisu on 10 sekuntia.
Jos kaikki 10 uudelleenyritystä epäonnistuvat, webhook-tapahtuma merkitään epäonnistuneeksi eikä sitä yritetä uudelleen. Varmista, että päätepisteesi vastaa nopeasti ja palauttaa 200-tilakoodin.
Täydelliset tiedot webhook-asetuksista ja datan rakenteesta löydät Webhookit-oppaasta.