Log ind  |  
Capturesiden, skridt 3

Efter kunden har indtastet data fra securetunnel.asp laves et kald (POST) til denne side, som så håndterer medsendte variabler.

 

POST request sendt til:

https://pay.onlinepayment.dk/securecapture.asp

tager følgende parametre:

 

Parameter

Beskrivelse

MerchantNumber
(krævet)

Forretningens unikke id. Tildelt af PBS (Krævet)

Amount

(krævet)

Beløb som hæves. (Krævet)

Bemærk, decimal separatoren er altid , (komma)

OrderID

(krævet)

Butikkens ID nr. for ordren (Krævet)

CurrencyID

(krævet)

Valutakode (ISO4217) 208 for DKK. (Valgfri). Default er 208

CardNumber

(krævet)

Kreditkortets nummer (Krævet)

CardCVC

(krævet)

Kontrolcifre (Krævet fra 1. april 2002)

ExpireMonth

(krævet)

Kreditkortets udløbsmåned (Krævet - længde:2)

ExpireYear

(krævet)

Kreditkortets udløbsår (Krævet - længde:2)

OKURL

Brugeren viderestilles til denne adresse hvis transaktionen bliver godkendt. (Valgfri)

Der tilføjes en parameter "transact" med transaktionsnr samt en parameter "orderid" med transaktionens ordreid. Desuden, tilføjes antal gange brugeren har forsøgt at betale (attempts)

(Hvis angivet tager denne prioritet over den OKURL der er angivet i administrationen)

FAILURL

Brugeren viderestilles til denne adresse hvis transaktionen bliver afvist. (Valgfri)

Desuden tilføjes en parameter "errorcode" med fejlkode.

(Hvis angivet tager denne prioritet over den FAILURL der er angivet i administrationen)

SessionID

SessionID (Valgfri)

OKStatusURL

Der foretages et skjult http kald til denne adresse hvis transaktionen bliver godkendt. (Valgfri)

Desuden tilføjes en parameter "transact" med transaktionsnummeret samt en parameter "orderid" med transaktionens ordreid.

FAILStatusURL

Der foretages et skjult http kald til denne adresse hvis transaktionen bliver afvist. (Valgfri)

Desuden tilføjes en parameter "errorcode" med fejlkoden.

(Hvis angivet tager denne prioritet over den FAILURL der er angivet i administrationen)

Port

Kan angives på OKStatusUrl og FailStatusUrl.

fx. <input type="hidden" name="port" value="8080"> vil denne blive brugt både på OKStatusUrl og FailStatusUrl.

Denne kan derfor med fordel benyttes til integrering med eksterne systemer. Også selvom server for modtagelse af status kaldene bruger anden port end standard port 80

ReferenceText

I ReferenceText er det muligt at angive en reference text til eget brug. Denne medtages på E-mailen der sendes fra Betalingssystemet ved gennemførsel af en transaktion. (Valgfri)

PayType

Sættes afhængig af om det er en almindelig kreditkort transaktion eller eDankort transaktion.

0 = Normal kreditkort (Default)

1 = eDankort

(Valgfri)

2 = 3D Secure (valgfri)

10 = eWire (valfri)

PostingID

KeyLabel

SigISO9796

AuthLifeCycle

Specielle signatur felter som bruges til eDankort. Alle 4 felter skal med og skal blot afspejle de data der modtages fra banken. (Vigtig: linierne skal med som det står her)

Checksum

ChecksumCalced = md5(OrderID & "+" & Amount & "+" & ChecksumSecretKey & "+" & CurrencyID)

Denne muliggør kontrol for svindel og "snyd" dersom evt. transaktioner der ikke opfylder Checksum specifikationer vil give fejl i betalingsøjemed.

kode for post:

<input type="hidden" name="checksum" value="info fra ChecksumCalced">

InstantCapture

Dvs. at det er muligt at foretage øjeblikkelig hævning af transaktionen lige efter autorisation.

eksempel på instantcapture felt:

<input type="hidden" name="instantcapture" value="1">

CardTypeID

Mulighed for at sende flere parametre for hvilke korttyper der kan benyttes. Se liste over korttyper: 3.6 Korttyper

SecureCapture.asp kan kaldes med følgende for kontrol af korttyper:

https://pay.onlinepayment.dk/SecureCapture.asp?CardTypeID=1,2,3,4

for, i dette eksempel, at begrænse betalingen til typerne:

Dankort, Visa, Mastercard og Visa / Dankort

 

TestMode

Hvis denne parameter medtages og sættes = 1 kører systemet i testmode. Dvs. at det er muligt at teste implementeringen op mod betalingsserveren, uden at der foretages nogen form for rigtig registrering.

For at simulere en betaling kan der testes med følgende kortnr.:

1111111111111111 = Godkendt kort

2222222222222222 = Afvist transaktion

Bemærk! Der genereres ikke nogen rigtig transaktion - dvs. at transaktionen ikke kan ses i administrationsmodulet.

Bemærk: Da der er tale om en test implementering, vil der ikke blive trukket informationer fra betalingssystem administrationen for OkUrl og FailUrl eksempelvis. Disse kan dog sættes ind i html formularen istedet.

<input type="hidden" name="TestMode" value="1">

 

(Valgfri)

 

Specielt for oprettelse af abonnementbetalinger

I tillæg til ovenstående, kan der angives om nye transaktioner skal oprettes som abonnementsbetalinger. Dette gøres ved at benytte:

 

Parameter

Beskrivelse

Format

RecurringPayment

(krævet)

Sættes denne til værdien 1, vil transaktionen blive oprettet som abonnementsbetaling.

<input type="hidden" name="RecurringPayment" value="1">

 

 

Int

RecurringCustNumber

(Krævet)

Her sættes kundenummer der skal tillæges til den nyoprettede abonnementsbetaling. Bemærk dette kundenummer bruges fremover som reference til det aktuelle abonnement.

 

String

RecurringDays

Angiver intervallet af dage mellem hver abonnementsbetaling.

 

Int

RecurringMonths

Angiver intervallet af måneder mellem hver abonnementsbetaling.

 

Int

RecurringNextCapure

 

Angiver hvornår den næste abonnementsbetaling skal finde sted. Datoformat for eksempelvis d. 22 oktober 2006 er:

22-10-06

 

String

 

 

Specielt for opdatering af eksisterende abonnemente Se punkt 2.4 under "Specielt for abonnementsbetalinger"PayApi Webservice

 

For at opdatere eksisterende abonnementer, som allerede figurerer i betalingssystemets administrationen, kan til securecapture.asp og payapi.asp medsendes variablen navngivet "UpdateExistingSubscriber".

 

 

Bemærk: For abonnementsbetalinger gælder også felter som OKURL, FAILURL, OKStatusURL og FAILStatusURL.

Bemærk: For abonnementsbetalinger gælder at de krævede felter for almindelige betalinger, såsom Amount, CardNumber og CardCVC mv. skal benyttes.

Fejlkoder

Hvis der opstår fejl under betalingstransaktionen medtages følgende fejlkoder til FAILURL samt FAILStatusURL kaldene.

Parameteren hedder "errorcode" og kan have følgende værdier:

 

 0 = Merchant/forretningsnummer ugyldigt

 1 = Ugyldigt kreditkortnummer

 2 = Ugyldigt beløb

 3 = OrderID mangler eller er ugyldig

 4 = PBS afvisning - (Oftest - ugyldig kortdata, spærret kort osv...).

 5 = Intern server fejl hos Conviator eller PBS

 6 = E-dankort ikke tilladt. Kontakt Conviator

 7 = ewire ikke tilladt. Kontakt Conviator

 8 = 3-D Secure ikke tilladt. Kontakt Conviator

 9 = ExpireMonth/ExpireYear Ugyldig.

10 = Ugyldig kreditkort type. (Creditcard type does not match CardTypeID)

11 = Ugyldig Checksum (Checksum mismatch)

12 = Instant Capture failed

13 = Recurring payments not allowed

14 = OrderID must be unique within same date

15 = Customer number for recurring payment must be unique

  
Ophavsret (c) 2012 Conviator Support portal  |  Vilkår for anvendelse  |  Om beskyttelse af private oplysninger