DocsPrófun samþættingar
Settu upp prófunarumhverfið þitt og notaðu prófunarskilríki
Áður en þú ferð í framleiðslu, notaðu Cost+ sandbox-vefsíðu til að staðfesta að samþættingin þín virki rétt. Ekkert sérstakt sandbox-URL er til — þú notar sama framleiðslu-API endapunkt (https://api.costplus.online/v1) með API lykli frá sandbox-vefsíðu.
Að fá prófunar-API lykilinn þinn
- Skráðu þig inn í gátt söluaðila
- Farðu í Vefsíður
- Stofnaðu nýja vefsíðu og veldu Sandbox sem tegund, eða veldu fyrirliggjandi sandbox-vefsíðu
- Smelltu á Samþætting til að finna API lykilinn þinn
- Notaðu þennan API lykil í samþættingunni þinni — allar færslur verða hermdar
Sandbox gagnvart framleiðsluham ræðst alfarið af tegund vefsíðu í gátt söluaðila, ekki af API URL-inu. API lykill sandbox-vefsíðu vinnur úr hermiðum færslum; API lykill framleiðsluvefsíðu vinnur úr raunverulegum greiðslum. Báðir nota sama API endapunkt.
Prófunarkortanúmer
Notaðu kortanúmerin hér að neðan til að herma eftir mismunandi greiðsluaðstæðum. Notaðu ekki raunveruleg kortanúmer í prófunarham.
| Kortanúmer | CVV | Tegund | Niðurstaða |
|---|---|---|---|
4111111111111111 | hvaða sem er | Visa | Vel heppnuð |
5544330000000037 | hvaða sem er | Mastercard | Vel heppnuð |
4462030000000000 | hvaða sem er | Visa | Vel heppnuð |
4111111111111105 | hvaða sem er | Visa | Hafnað |
4111111111111143 | hvaða sem er | Visa | Stolið kort |
4111111111111151 | hvaða sem er | Visa | Ófullnægjandi innistæða |
Notaðu hvaða framtíðargildi og 3 stafa CVC sem er.
Prófunarkortanúmer virka aðeins í sandbox-ham. Sending þeirra á API lykil framleiðsluvefsíðu mun leiða til hafnaðrar færslu.
Villukóðar
Þegar færsla mistekst skilar API einum af eftirfarandi villukóðum í reason reit færslunnar:
| Villukóði | Lýsing |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS auðkenning var ekki lokið í tíma; greiðslu hætt |
ERROR_CARD_CVV_NOT_VALID | CVV rétt sniðið en ekki gilt |
ERROR_CARD_INFORMATION_NOT_VALID | Kortaupplýsingar rétt sniðnar en ekki gildar |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Færsla ekki studd fyrir rafræn viðskipti |
ERROR_CARD_NOT_VALID | Kortakenni er ekki gilt |
ERROR_CARD_TYPE_DISABLED | Kortategund er óvirk |
ERROR_TRANSACTION_FAILED | Kortafærsla mistókst |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Hafnað af vinnsluaðila (inniheldur Visa/MC tölulegan kóða) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tegund færslu ekki leyfð af seljanda |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Ekki stutt af kortaneti |
INVALID_CARD_CVV | CVV ekki þekkt |
INVALID_CARD_NUMBER | Kortanúmer ekki þekkt |
Algengar API-staðfestingarvillur
Þessar villur eru skilaðar sem 400 Bad Request þegar API-beiðnin sjálf er ógild:
| Villa | Lýsing |
|---|---|
| Unknown payment method | Þú gafst upp rangt nafn greiðslumáta |
| No permissions for payment method | API lykillinn þinn (verkefni) hefur ekki heimildir fyrir tilgreindum greiðslumáta |
| Payment method not enabled | Greiðslumátinn hefur ekki verið virkjaður fyrir API lykilinn þinn (verkefni) |
| Payment method not supported | API lykillinn þinn (verkefni) hefur ekki rétta stöðu til að nota tilgreindan greiðslumáta |
Ef þú færð "Payment method not enabled" eða "No permissions", athugaðu stillingar greiðslumáta í gátt söluaðila undir stillingum vefsíðunnar þinnar.