Brug af API?er til betalingsgatewayen.

API?erne virker alle ved at man poster informationer til en bestemt URL under en HTTPS forbindelse. Følgende funktioner er tilgængelig udenfor betalingsgatewayen?s interface.

1. Cancel Transaction.
2. Capture Transaction.
3. Change Amount.
4. Check Transaction.
5. Renew Transaction.

For at bruge de ovenstående API funktioner, skal man angive transaktionsnummeret til én af de følgende links.
Efter at have postet til den angivede URL, vil du blive spurgt efter et brugernavn og password. Det er de samme oplysninger, som du bruger når du logger på betalingsgatewayen?s interface.
Alle de nedstående API funktioner, har mulighed for at retunere informationerne tilbage, ved at redirecte tilbage til en forudbestemt url.
Eks. https://betaling.123hotel.dk/api/pg.api.canceltransack.php?transacknum=34922&url=http://www.domæne.dk/action.php

1. Cancel Transaction. ( Annuller transaktion )

Eks. https://betaling.123hotel.dk/api/pg.api.canceltransack.php?transacknum=34922

Cancel Transaction bruges til at annullere transaktioner udenfor betalingsgatewayen?s interface.
Hvis annulleringen af transaktionen blev gennemført, vil denne API returnere:

APPROVED: [En standard, der fortæller at kortet er accepteret]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis annulleringen af transaktionen ikke blev gennemført, vil denne API returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret] 
ERROR: [Fejlbeskrivelse, hvis transaktionen ikke er gennemført]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

2. Capture Transaction. ( Gennemfør transaktion )

Eks. https://betaling.123hotel.dk/api/pg.api.capturetransack.php?transacknum=23123

Capture Transaction kan gennemføre transaktioner udenfor betalingsgatewayen?s interface.

Udover det har du også muligheden for at sammenligne beløbet fra din ordre op mod det beløb som står i betalingatewayen, for at sikre at transaktionen er gennemført korrekt.

Hvis en capture er gennemført korrekt, vil denne API returnere:

APPROVED: [En standard, der fortæller at kortet er accepteret]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis en capture ikke blev gennemført, vil denne API returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret] 
ERROR: [Fejlbeskrivelse, hvis transaktionen ikke er OK] 
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis en capture ikke blev gennemført, fordi de sammenlignede beløb ikke var ens, vil den returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret]
ERROR: AMOUNT NOT IDENTICAL
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

3. Change Amount ( Ændre beløb på en transaktion )

Eks. https://betaling.123hotel.dk/api/pg.api.changeamount.php?transacknum=2342&&amount=5000&currency=208

Change Amount, bruges til at ændre beløbet på en given transaktion.

Amount skal skrives som minor unit ( øre ). Currency skal udfyldes, selvom man ikke ønsker at ændre valutaen på transaktionen. Currency skal desuden overholde ISO4217 standarden. ISO koderne til de forskellige valutaer, findes på denne liste.

Hvis en changeamount er gennemført korret, vil denne API returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis changeamount ikke blev gennemført, fordi det definerede beløb er for højt, i forhold til det gamle. Vil den returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret]
ERROR: AMOUNT IS TOO HIGH
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis en changeamount ikke er gennemført, fordi et changeamountjob for det valgte transaktionsnummer ikke er kørt, vil den returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret]
ERROR: ALREADY A JOB IN QUEUE
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis changeamount ikke  blev gennemført, fordi amount variablen er formateret forkert, vil den returnere:

DECLINED: [En standard, der fortæller at kortet er accepteret]
ERROR: AMOUNT NOT A VALID FORMAT
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

 4. Check Transaction. ( Check om transaktionen er gennemført. )

Eks. https://betaling.123hotel.dk/api/pg.api.checktransack.php?transacknum=1234&shopid=20043123124

Check transaction, bruges til at verificere om transaktionen er gennemført efter kunden har afgivet sin bestilling. Vi anbefaler helt sikkert at bruge denne funktion, da kunder med bare lidt kendskab til web-programmering, har mulighed for at manipulere med den post der bliver lavet af betalingsgatewayen.

API?en retunere fålgende resultat.

En transaktion der er lavet en auth på, vil retunere:

AUTH-APPROVED: [En standard, der fortæller at kortet er acceptere]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

En transaktion der er lavet en capture på, vil retunere:

CAPTURE-APPROVED: [En standard, der fortæller at transaktionen er gennemført]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

Hvis transaktionen ikke findes, eller ikke er gennemført, vil det returnerede svar være:

DECLINED: [En standard, der fortæller at transaktionen er gennemført]
ERROR: [Fejlbeskrivelse, hvis transaktionen ikke er OK]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

5. Renew Transaction. ( Renew en transaktionen. )

Eks. https://betaling.123hotel.dk/api/pg.api.renewtransack.php?transacknum=1234&shopid=20043123124

Renew transaction, bruges til at lave renew på transaktioner der er udløbet

API'en retunere følgende resultat.

En gokendt renew, vil retunere:

APPROVED: [En standard, der fortæller at kortet er acceptere]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]

En ikke godkendt renew, vil retunere:

DECLINED: [En standard, der fortæller at transaktionen er gennemført]
ERROR: [Fejlbeskrivelse, hvis transaktionen ikke er OK]
AMOUNT: [Beløbet på transaktionen, vist i minor unit (øre)]
ORDERID: [Ordrenummeret for transaktionen]