DocsIntegraation testaus
Määritä testiympäristösi ja käytä testitunnuksia
Ennen tuotantoon siirtymistä käytä Cost+ sandbox-verkkosivustoa varmistaaksesi, että integraatiosi toimii oikein. Erillistä sandbox-URL:ää ei ole — käytät samaa tuotanto-API-päätepistettä (https://api.costplus.online/v1) sandbox-verkkosivuston API-avaimella.
Testi-API-avaimen hankkiminen
- Kirjaudu kauppiasportaaliin
- Siirry kohtaan Websites
- Luo uusi verkkosivusto ja valitse tyypiksi Sandbox, tai valitse olemassa oleva sandbox-sivusto
- Napsauta Integration löytääksesi API-avaimesi
- Käytä tätä API-avainta integraatiossasi — kaikki tapahtumat simuloidaan
Sandbox- vs. tuotantotila määräytyy kokonaan verkkosivuston tyypin perusteella kauppiasportaalissa, ei API-URL:n perusteella. Sandbox-verkkosivuston API-avain käsittelee simuloituja tapahtumia; tuotantosivuston API-avain käsittelee oikeita maksuja. Molemmat käyttävät samaa API-päätepistettä.
Testikorttinumerot
Käytä alla olevia korttinumeroita eri maksutilanteiden simuloimiseen. Älä käytä oikeita korttinumeroita testitilassa.
| Korttinumero | CVV | Brändi | Tulos |
|---|---|---|---|
4111111111111111 | mikä tahansa | Visa | Onnistunut |
5544330000000037 | mikä tahansa | Mastercard | Onnistunut |
4462030000000000 | mikä tahansa | Visa | Onnistunut |
4111111111111105 | mikä tahansa | Visa | Do Not Honor |
4111111111111143 | mikä tahansa | Visa | Stolen Card |
4111111111111151 | mikä tahansa | Visa | Insufficient Funds |
Käytä mitä tahansa tulevaa voimassaolopäivää ja mitä tahansa 3-numeroista CVC:tä.
Testikorttinumerot toimivat vain sandbox-tilassa. Niiden lähettäminen tuotantosivuston API-avaimella johtaa hylättyyn tapahtumaan.
Virhekoodit
Kun tapahtuma epäonnistuu, API palauttaa yhden seuraavista virhekoodeista tapahtuman reason-kentässä:
| Virhekoodi | Kuvaus |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-todennus ei valmistunut ajoissa; maksu peruutettu |
ERROR_CARD_CVV_NOT_VALID | CVV on oikein muotoiltu mutta ei kelpaa |
ERROR_CARD_INFORMATION_NOT_VALID | Korttitiedot ovat oikein muotoiltuja mutta eivät kelpaa |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Tapahtumaa ei tueta verkkokaupassa |
ERROR_CARD_NOT_VALID | Kortin tunniste ei kelpaa |
ERROR_CARD_TYPE_DISABLED | Korttityyppi on poistettu käytöstä |
ERROR_TRANSACTION_FAILED | Korttitapahtuma epäonnistui |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Prosessori hylkäsi (sisältää Visa/MC-numeerisen koodin) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Myyjä ei salli tätä tapahtumatyyppiä |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Korttiverkko ei tue |
INVALID_CARD_CVV | CVV:tä ei tunnistettu |
INVALID_CARD_NUMBER | Korttinumeroa ei tunnistettu |
Yleiset API-validointivirheet
Nämä virheet palautetaan 400 Bad Request -vastauksena, kun itse API-pyyntö on virheellinen:
| Virhe | Kuvaus |
|---|---|
| Unknown payment method | Annoit virheellisen maksutavan nimen |
| No permissions for payment method | API-avaimellasi (projektilla) ei ole oikeuksia määritettyyn maksutapaan |
| Payment method not enabled | Maksutapaa ei ole otettu käyttöön API-avaimellesi (projektille) |
| Payment method not supported | API-avaimellasi (projektilla) ei ole oikeaa tilaa määritetyn maksutavan käyttöön |
Jos saat virheen "Payment method not enabled" tai "No permissions", tarkista maksutavan asetukset kauppiasportaalista verkkosivustosi asetusten alta.