Integration til Recuro - Rapporter
Abonnementsrapport
URL: https://www.recuro.dk/api/http/subreport
En abonnementsrapport indeholder information om abonnementer der matcher en række søge kriterier. Formatet på rapporten er CSV.
| Parameter | Beskrivelse | |
|---|---|---|
| merchant | N10 | Identifikationen af din butik. Er udleveret af Recuro ved oprettelsen. |
| username | AN100 | Brugernavn |
| password | AN100 | Password |
| [subno] | AN50 | Valgfrit subno argument. Hvis angivet er rapporten kun for dette abonnement. |
| [status] | AN | Der kan benyttes TICKET_PENDING, ACTIVE, ACTIVE_PENDING, ACTIVE_MISSING, TICKET_FAILED, PAUSED og CLOSED. |
| [created_from] | AN | Abonnementer oprettet efter denne dato. Format: dd-mm-yyyy |
| [created_to] | AN | Abonnementer oprettet før denne dato. Format: dd-mm-yyyy |
| [rule] | N | Abonnementer med den angivne regel. |
| [email] | AN | Abonnementer med denne kunde e-mail. Der kan benyttes delvis adresse, f.eks. jens@. |
| [name] | AN | Abonnementer med dette kunde navn. Der kan benyttes delvist navn, f.eks. Jens Jen. |
| [address] | AN | Abonnementer med denne adresse. Der kan benyttes delvis adresse, f.eks. Nygade. |
| [phone] | AN | Abonnementer med dette telefonnummer. Der kan benyttes delvist nummer, f.eks. 3330. |
| [card] | AN | Abonnementer med dette kort tilknyttet. Der kan søges på første seks, og sidste 4 cifre i kortnummeret. Flere søgekriterier separeres med mellemrum. F.eks. "501910 0000". |
Betalingsrapport
URL: https://www.recuro.dk/api/http/payreport
En betalingsrapport indeholder oplysninger om de betalinger som enten er oprettet, udestående, gennemført eller fejlet for en given periode. Følgende parametre kan benyttes.
| Parameter | Beskrivelse | |
|---|---|---|
| merchant | N10 | Identifikationen af din butik. Er udleveret af Recuro ved oprettelsen. |
| username | AN100 | Brugernavn |
| password | AN100 | Password |
| [subno] | AN50 | Valgfrit subno argument. Hvis angivet er rapporten kun for dette abonnement. |
| [startdate] | AN | Betalinger oprettet/gennemført/fejlet på eller efter denne dato. Hvis ikke angivet benyttes dags dato. Format: dd-mm-yyyy |
| [enddate] | AN | Betalinger oprettet/gennemført/fejlet på eller før denne dato. Hvis ikke angivet benyttes dags dato. Format: dd-mm-yyyy |
| [status] | AN | Status for betalinger. Enten oprettet, udestående, gennemført eller fejlet. Følgende værdier kan benyttes CREATED, PENDING, CAPTURED og FAILED. Som standard benyttes CAPTURED. |
| [type] | AN | Rapporten genereres enten som kommsepareretfil CSV, eller XML. Følgende værdier kan benyttes: CSV | XML. Som standard benyttes CSV. |
CSV format
CSV formatet er vist herunder med et eksempel
subno,sub_status,pay_id,pay_amount,pay_currency,pay_captured,pay_created
sub005,ACTIVE,400779,CAPTURE_APPROVED,1000,DKK,21-01-2009-01:31,21-01-2009-00:00
sub005,ACTIVE,400780,CAPTURE_APPROVED,2000,DKK,21-01-2009-01:31,21-01-2009-00:00
sub006,ACTIVE,400781,CAPTURE_APPROVED,2000,DKK,21-01-2009-01:53,21-01-2009-00:00
sub006,ACTIVE,400782,PENDING,2000,DKK,,21-01-2009-00:00
subno,amount,currency,count
sub005,3000,DKK,2
sub006,4000,DKK,2
amount,currency,count
7000,DKK,4
Rapporten har tre dele adskilt af blank linje. Den første del indeholder samtlige betalinger. I dette tilfælde for den 21/01-2009. Der er to abonnementer sub005 og sub006, hver med to betalinger. Følgende er angivet for hver betaling: abonnementnummer, abonnementstatus, betalings id, betalingsstatus, beløb, valuta, dato for gennemførsel og dato for oprettelse.
Den anden del indeholder totaler for hvert abonnement og valuta. Den tredje del er totaler for hver benyttet valuta på tværs af alle abonnementer.
XML format
XML versionen har samme opbygning som CSV versionen. Herunder tilsvarende eksempel.
<?xml version="1.0" encoding="UTF-8"?>
<payreport>
<payments>
<payment pay_amount="1000" pay_captured="21-01-2009-01:31" pay_created="21-01-2009-00:00" pay_currency="DKK" pay_id="400779" pay_status="CAPTURE_APPROVED" sub_status="ACTIVE" subno="sub005"/>
<payment pay_amount="2000" pay_captured="21-01-2009-01:31" pay_created="21-01-2009-00:00" pay_currency="DKK" pay_id="400780" pay_status="CAPTURE_APPROVED" sub_status="ACTIVE" subno="sub005"/>
<payment pay_amount="2000" pay_captured="21-01-2009-01:53" pay_created="21-01-2009-00:00" pay_currency="DKK" pay_id="400781" pay_status="CAPTURE_APPROVED" sub_status="ACTIVE" subno="sub006"/>
<payment pay_amount="2000" pay_captured="" pay_created="21-01-2009-00:00" pay_currency="DKK" pay_id="400782" pay_status="PENDING" sub_status="ACTIVE" subno="sub006"/>
</payments>
<subtotal>
<subscription amount="3000" count="2" currency="DKK" subno="sub005"/>
<subscription amount="4000" count="2" currency="DKK" subno="sub006"/>
</subtotal>
<total amount="7000" count="4" currency="DKK"/>
</payreport>
Nyhedsbrev
Tilmeld dig vores nyhedsbrev og få en email når integrationsvejledningen, bliver opdateret.