Integration til Recuro - Introduktion
Her finder du relavant teknisk dokumentation for integration til Recuro. Denne vejledning er version 1.7 og er opdateret den 26/09-2010, har du spørgsmål kan du kigge i vores FAQ under support eller skrive til os på vores kontaktside.
En API reference på engelsk kan downloaded her:
For at kunne teste integrationen uden at være oprettet som kunde, kan demo-kunden med id 1 benyttes. Brugernavn/password er: demoshop/demoshop
For API kald der kræver brugernavn/password skal følgende benyttes: demoapi/demoapi
HTTP POST
Integration til Recuro udføres med HTTP POST forespørgelser. I de fleste tilfælde vil der være tale om server-til-server kald, hvor svaret i text/plain er på formen:
Værdierne er URL kodede. Et svar indeholder altid som minimum følgende:
hvor xx er en numerisk fejlkode. Nul (0) betyder ingen fejl. For alle andre værdier vil der også blive returneret en tekstuel fejlmeddelelse. Eksempel på fejlmeddelelse:
Liste af fejlmeddelelser kan ses nederst.
Notation
Følgende format vil blive benyttet til at beskrive parametre
| Nxx | Numerisk værdi maks. xx tegn |
| ANxx | Alfanumerisk værdi maks. xx tegn |
| [parameter] | Valgfri parameter. Alle andre er obligatoriske. |
Fejlkoder
Liste over fejlkoder og betydning.
| Fejlkode | Fejltekst | Betydning |
|---|---|---|
| 0 | OK | Ingen fejl |
| 10 | Missing merchant id | Merchant argument mangler |
| 11 | Date parse error | Startdato eller slutdato format er ikke korrekt. |
| 12 | Missing subno | Abonnementsnummer argument mangler |
| 13 | Missing rule | Regel argument mangler |
| 14 | Missing email | E-mail argument mangler |
| 15 | Unknown merchant | Merchant kunne ikke findes |
| 16 | Unknown rule | Regel kunne ikke findes |
| 17 | No active agreement found | Der kunne ikke findes aktive aftaler for merchant |
| 18 | Duplicate subno | Abonnementsnummer findes allerede |
| 19 | Wrong subno | Forkert abonnementsnummer |
| 20 | Ticket cancelled | Tilknytning af kortoplysninger blev afbrudt |
| 21 | Internal Recuro error | Der er opstået en udianogsticerbar fejl hos Recuro |
| 22 | Missing username | Argumentet username mangler |
| 23 | Missing password | Argumentet password mangler |
| 24 | Missing amount | Argumentet amount mangler |
| 25 | Missing ordertext | Argumentet ordertext mangler |
| 26 | Unknown subscription | Abonnement kunne ikke findes |
| 27 | Failed to send email | E-mail kunne ikke afsendes |
| 28 | Wrong username or password | Brugernavn og/eller password er ikke korrekt |
| 29 | Not API user | Den angivne bruger har ikke API adgang |
| 30 | Already closed | Abonnementet er allerede lukket |
| 31 | Invalid amount | Beløbet er ikke korrekt formateret |
| 32 | Unknown currency | Valuta kunne ikke genkendes |
| 33 | Unknown create model | Værdien til argumentet create_model kunne ikke genkendes |
| 34 | Unknown fail model | Værdien til argumentet fail_model kunne ikke genkendes |
| 35 | Subscription closed | Abonnement er lukket og handling kan derfor ikke gennemføres |
| 36 | Rule inactive | Reglen kan ikke benyttes da der er inaktiv |
| 37 | Missing name | Argumentet name mangler |
| 38 | Missing description | Argumentet description mangler |
| 39 | Missing currency | Argumentet currency mangler |
| 40 | Missing rule type | Argumentet ruletype mangler |
| 41 | Uknown ruletype | Værdien til argumentet ruletype kunne ikke genkendes |
| 42 | Duplicate rule | Reglen findes allerede |
| 43 | Wrong status | Argumentet status kunne ikke genkendes |
| 44 | Wrong type | Argumentet type kunne ikke genkendes |
| 45 | Report failure | Rapport kunne ikke genereres |
| 46 | Subscription not pending | Abonnement kunne ikke slettes da det ikke er i status afventende |
| 47 | Subscription number too long | Angivet subno er længere end de tilladte 50 karakterer |
| 48 | Merchant closed | Operationen kunne ikke udføres da merchant er lukket |
| 49 | Invalid duration | Angivet duration i pause kald er forkert |
| 50 | Service down for maintenance | Servicen kunne ikke udføres da den er under vedligehold |
| 51 | Invalid startdate | Angivet startdate argument er tilladt. Det er kun tilladt at ændre startdate hvis en af følgende betingelser er opfyldt:
|
| 52 | Invalid email | Angivet email adresse er ikke på korrekt format |
| 53 | Name too long | Navn for regel er længere end de tilladte 50 karaktere |
| 54 | Missing extra charge | Argument extra_charge ikke angivet |
| 55 | Unknown extra charge | Extra charge kunne ikke findes |
| 56 | Extra charge not pending | Extra charge kunne ikke cancelleres da den ikke er udestående |
| 57 | Missing discount | Argument discount ikke angivet |
| 58 | Unknown discount | Discount kunne ikke findes |
| 59 | Discount not pending | Discount kunne ikke cancelleres da den ikke er udestående |
| 60 | Payment already scheduled | Der er scheduleret betalinger efter den angivne start dato for pause. Start datoen kan derfor ikke benyttes, da produkter allerede er leveret i den ønskede pause periode |
Nyhedsbrev
Tilmeld dig vores nyhedsbrev og få en email når integrationsvejledningen, bliver opdateret.