TEKNISK KALL GRENSESNITT FOR UIO PAY

Oddmund Møgedal
oddmund.mogedal@usit.uio.no

Dette dokumentet beskriver hvordan en konferanse webside (bestillingsystem) kan koble seg til 
betalingssystemet.

Det er i praksis to alternativer:

a.)
Konferanse websiden har en fast link til betalingssidene.
Brukeren må da fylle ut alle navn og adresseoppysninger på betalingssidene.

Dersom det ikke er behov for å samle inn opplysninger fra folk før de betaler, så vil dette
ofte være den mest hensiktsmessige måten. Konferanse websidene vil da i enkelte tilfeller ikke ha behov
for å ta vare på opplysninger fra brukeren i det hele tatt (siden opplysningene vil kunne hentes fra 
betalingstjenesten).

b.)
Konferanse websiden kan samle inn en del eller alle opplysninger og så sende opplysningene og brukeren
videre til betalingssystemet enten ved å

i.
generere en dynamisk bekreftelsesside for bestillingen med en dynamisk generert link (med parametre) 
som brukeren skal trykke på for å gå til betalingssystemet

eller ved å

ii.
redirecte brukeren til betalingssystemet med samme genererte link (med parametre)

Brukeren vil så få opp siden for registrering av navn og adresseopplysnigner (mer eller mindre) 
ferdig utfylt.
Brukeren vil så ha muligheten til å endre opplysningene/legge til opplysninger i andre felt
før han/hun går videre.

Parameteren externalId kan brukes til å knytte en gitt bestilling/påmelding til en gitt betaling.

******
URL:
******

Test:
https://cyclorrhapha.uio.no/pay/shop.ordercreate.action

Produksjon:
https://www.uio.no/pay/shop.ordercreate.action


************
Parametre:
************

Feltene som brukes til å skrive inn opplysninger bør være de samme som sendes til oss 
(dvs. f.eks separate felt for fornavn og etternavn). 
Dette for å unngå forvirring hvis pay og eller netaxept mener det er noe feil og brukeren 
må rette dette.

Feltene skal sendes som URL encoded form parametre (i henhold til HTML 4 standarden).
Dette betyr bla. at mellomrom i variabler skal settes til + og at f.eks. æøæ må sendes 
som %.

Obligatoriske felt er merket med *
(dvs. at de må fylles ut av bruker hvis de ikke sendes med) 

project * 

project er obligatorisk for å gå til pay siden for registrering av kundeinfo, med eller 
uten ferdig utfylte data basert på andre parametre nedenfor.

firstname *
lastname *
orgname
address1 *
address2
zip *
city *
countryCode *
email *
phone
cellphone
fax
externalId

externalId er en vilkårlig ID (f.eks. et løpenummer for bestillinger/påmeldinger) som kan sendes med til 
betalingssystemet. Det kan brukes til å knytte en gitt bestilling/påmelding til en gitt betaling. 
Feltet er tilgjengelig på rapporter fra betalingssystemet.


Eksempler:

a.)
For å gå til pay siden for utfylling av kundeinfo:

https://cyclorrhapha.uio.no/pay/shop.ordercreate.action?project=1000

b.)
For å gå til pay siden for utfylling av kundeinfo med ferdig utfylte data:

https://cyclorrhapha.uio.no/pay/shop.ordercreate.action?project=1000&firstname=Oddmund&lastname=Mogedal&orgname=UiO&address1=Svingen+1&address2=&zip=1384&city=Asker&countryCode=NO&email=oddmund.mogedal@usit.uio.no&phone=22840054&cellphone=&fax=


***************************
Testsystemet hos Netaxept
***************************

Testsystemet hos oss er koblet til testsystemet hos Netaxept.

Reelle kredittkortnummer skal ikke brukes til testing, blant annet fordi de sendes ukryptert mellom testsystemene.

Ved testing brukes kredittkort som følger:

VISA:
4 som første siffer. Må være 16 siffer. 1 i siste siffer gir OK. 0 i siste siffer gir "feil hos kortselskap".

MasterCard/EuroCard:
5 som første siffer. Må være 16 siffer. 1 i siste siffer gir OK. 0 i siste siffer gir "feil hos kortselskap".