Batch processing

Vi anbefaler, at filer til Bambora navngives i følgende format: ÅÅÅÅMMDDTT (år, måned, dato, time)

Filer fra Bambora til virksomheden gemmes i OUT-mappen i følgende format: ÅÅÅÅMMDDTT

Transaktioner, som af en eller anden grund ikke bliver gennemført, gemmes i følgende format, når Bambora genererer output-filen: ÅÅÅÅMMDDTT_pending

Filer gemmes som pending, hvis f.eks.:

• En transaktion skal hæves på et senere tidspunkt (dette kan virksomheden styre)
• Autorisationen af en instant capture skal ske på et senere tidspunkt
• Bambora ikke kunne behandle transaktionen

En række i denne fil indeholder følgende oplysninger:

Input	Type	Værdier	Beskrivelse
Operation	Integer		Den handling, der skal foretages på transaktionen: 1. Capture (hæv beløb) 2. Credit (krediter beløb) 3. Delete (slet transaktion) 4. Authorise subscription (autoriser betaling på et abonnement) 5. Delete subscription (slet abonnement)
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale (f.eks. med Nets).
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen. Hvis operation = 4 eller 5, er dette felt tomt (blank).
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet. Hvis operation = 1, 2 eller 3, er dette felt tomt (blank).
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet.
Date	Date	20130115 ÅÅÅÅMMDD	Den dato, hvor handlingen skal udføres. Hvis f.eks. betalingen skal hæves den 21. juni 2013, sættes datoen til 20130621.

Bemærk venligst, at det ikke er nødvendigt at gøre noget ved denne fil. Det er blot information fra Bambora til virksomheden om transaktioner, der afventer behandling.

Transaktioner, som ikke kunne gennemføres på grund af fejl hos Bambora eller indløseren, gemmes i følgende format i OUT-mappen: ÅÅÅÅMMDDTT_error

Bemærk, at når en sådan fil genereres, sendes der en e-mail til virksomheden og Bamboras support.

En række i denne fil indeholder følgende oplysninger:

Input	Type	Værdier	Beskrivelse
Operation	Integer		Den handling, der skal foretages på transaktionen: 1. Capture (hæv beløb) 2. Credit (krediter beløb) 3. Delete (slet transaktion) 4. Authorise subscription (autoriser betaling på et abonnement) 5. Delete subscription (slet abonnement)
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen. Hvis operation = 4 eller 5, er dette felt tomt (blank).
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet. Hvis operation = 1, 2 eller 3, er dette felt tomt (blank).
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet.
ActionCode	String	0-9 a-Z	Den fejlkode, der beskriver, hvorfor transaktionen blev afvist.

Bemærk venligst, at du skal foretage en manuel handling på transaktionerne i denne fil. Transaktionerne bliver ikke behandlet igen. Den sædvanlige procedure vil være at sende informationen til Bambora i en ny batch-fil.

Bambora behandler transaktionerne løbende, som vi modtager dem. Du vælger selv, om du vil modtage én samlet output-fil, som vi sender én gang i døgnet, eller du vil modtage en output-fil per input-fil. Vælger du at modtage flere output-filer, sendes svarfilen, så snart alle rækker i input-filen er behandlet. 

Hvis du vil modtage én output-fil, aftaler du tidspunktet for afsendelse med os. 

Filer, der er ældre en 30 dage, slettes fra OUT-mappen.

Filer i IN-mappen slettes, når de er behandlet. De flyttes til ARCHIVE-mappen efter behandling. Filer i ARCHIVE-mappen slettes efter 30 dage.

Input-felterne er de felter, du skal sende til Bambora.

Input	Type	Værdier	Beskrivelse	Obligatorisk
Operation	Integer	1 (låst)	Den handling, der skal foretages på transaktionen.	Ja
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.	Ja
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.	Ja
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet. Bemærk, at hvis denne er 0, hæves det fulde beløb.	Ja
Group	String	Maks. 100 karakterer	Den gruppe, som betalingen skal tilknyttes.	Nej
CaptureDate	Date	20130115 ÅÅÅÅMMDD	Hvis feltet ikke er tomt, hæves betalingen på den angivne dato. Datoen kan maksimalt være dags dato + 14 dage.	Nej

Output-felterne er dem, som Bambora returnerer.

Output	Type	Værdier	Beskrivelse
Operation	Integer	1 (låst)	Den handling, der er foretaget på transaktionen.
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet. Hvis der i input-filen stod 0, vises det fulde hævede beløb her.
Epayresponse / action code	String	0 = succes	Hvis denne værdi ikke er = 0, skal du finde årsagen til, handlingen blev afvist, ved at slå fejlkoden op på listen over fejlkoder i din Bambora-administration.

Input-felterne er de felter, du skal sende til Bambora.

Input	Type	Værdier	Beskrivelse	Obligatorisk
Operation	Integer	2 (låst)	Den handling, der skal foretages på transaktionen.	Ja
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.	Ja
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.	Ja
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet. Bemærk, at hvis denne er 0, krediteres hele beløbet.	Ja
Group	String	Maks. 100 karakterer	Den gruppe, som betalingen skal tilknyttes.	Nej

Output-felterne er dem, som Bambora returnerer.

Output	Type	Værdier	Beskrivelse
Operation	Integer	2 (låst)	Den handling, der er foretaget på transaktionen.
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet. Hvis der i input-filen stod 0, vises det fulde krediterede beløb her.
Epayresponse / action code	String	0 = succes	Hvis denne værdi ikke er = 0, skal du finde årsagen til, at handlingen blev afvist, ved at slå fejlkoden op på listen over fejlkoder i din Bambora-administration.

Input-felterne er de felter, du skal sende til Bambora.

Input	Type	Værdier	Beskrivelse	Obligatorisk
Operation	Integer	3 (låst)	Den handling, der skal foretages på transaktionen.	Ja
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.	Ja
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.	Ja
Group	String	Maks. 100 karakterer	Den gruppe, som betalingen skal tilknyttes.	Nej

Output-felterne er dem, som Bambora returnerer.

Output	Type	Værdier	Beskrivelse
Operation	Integer	3 (låst)	Den handling, der er foretaget på transaktionen.
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.
Transactionid	Long		Det unikke nummer, der identificerer betalingen. Det returneres ved autorisationen.
Epayresponse / action code	String	0 = succes	Hvis denne værdi ikke er = 0, skal du finde årsagen til, at handlingen blev afvist, ved at slå fejlkoden op på listen over fejlkoder i din Bambora-administration.

Input-felterne er de felter, du skal sende til Bambora.

Input	Type	Værdier	Beskrivelse	Obligatorisk
Operation	Integer	4 (låst)	Den handling, der skal foretages på abonnementet.	Ja
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.	Ja
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet.	Ja
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet. Bemærk, at beløbet SKAL være større end 0.	Ja
Currency	String	208 = DKK 978 = EUR 840 = USD	Den valuta, som betalingen skal gennemføres i.	Ja
Instantcapture	Int	0 = false 1 = true	Hvis denne sættes til 1, hæves betalingen øjeblikkeligt. Som udgangspunkt er den sat til 0, og du skal manuelt hæve betalingen fra din Bambora-administration, via API eller gennem batch-filer.	Ja
CaptureDate	Date	20130115 ÅÅÅÅMMDD	Hvis feltet ikke er tomt, hæves betalingen på den angivne dato. Dette felt ignoreres, hvis Instantcapture = 1. Datoen kan maksimalt være dags dato + 14 dage.	Nej
Group	String	Maks. 100 karakterer	Den gruppe, som betalingen skal tilknyttes.	Nej
Description	String	Maks. 1024 karakterer	En beskrivelse af betalingen. Beskrivelsen kan ses i din Bambora-administration.	Nej
Addfee	Int	0 = false 1 = true	Hvis denne er sat til 1, vil Bambora udregne transaktionsgebyret og lægge det til beløbet.	Ja
Orderid	String	A-z 0-9	Det ordre-ID, som betalingen skal have. Hvis denne er tom, bliver transaktions-ID'et brugt - ellers bruges dato-tid.	Nej

Output-felterne er dem, som Bambora returnerer.

Output	Type	Værdier	Beskrivelse
Operation	Integer	4 (låst)	Den handling, der er foretaget på abonnementet.
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale (f.eks. med Nets).
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet.
Amount	Long	Mindste enheder	Beløbet i mindste enheder. F.eks. skal DKK 125,75 skrives som 12575 i amount-feltet.
Currency	String	208 = DKK 978 = EUR 840 = USD	Valutaen, som betalingen gennemføres i.
Transactionid	Long		Det transaktions-ID, som skabes ved autorisationen. Hvis autorisationen afvises, vil værdien i dette felt være 0.
Fee	Long	Mindste enheder	Hvis input-parameteren addfee var = 1, fremgår gebyret i dette felt. Bemærk venligst, at output-parameteren amount IKKE indeholder gebyret.
Epayresponse / action code	String	0 = succes	Hvis denne værdi ikke er = 0, skal du finde årsagen til, handlingen blev afvist, ved at slå fejlkoden op på listen over fejlkoder i din Bambora-administration.

Input-felterne er de felter, du skal sende til Bambora.

Input	Type	Værdier	Beskrivelse	Obligatorisk
Operation	Integer	5 (låst)	Den handling, der skal foretages på abonnementet.	Ja
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.	Ja
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet.	Ja
Group	String	Maks. 100 karakterer	Den gruppe, som betalingen skal tilknyttes.	Nej

Output-felterne er dem, som Bambora returnerer.

Output	Type	Værdier	Beskrivelse
Operation	Integer	5 (låst)	Den handling, der er foretaget på abonnementet.
Merchantnumber	Integer	7-10 cifre	Dit unikke forretningsnummer. Du kan finde det på din indløsningsaftale.
Subscriptionid	Long		Det unikke nummer, der identificerer abonnementet.
Epayresponse / action code	String	0 = succes	Hvis denne værdi ikke er = 0, skal du finde årsagen til, handlingen blev afvist, ved at slå fejlkoden op på listen over fejlkoder i din Bambora-administration.

Sådan ser en datarække ud, når en transaktion hæves. Input-felterne defineres således:

Parameter	Værdi
Operation	1
Merchantnumber	12345678
Transactionid	987654321
Amount	2000
Group	(blank)

CSV-rækken vil se således ud:

1;12345678;987654321;2000;;

Hvis transaktionen godkendes, ser svarrækken sådan ud:

1;12345678;987654321;2000;0;