Documentation

Borgun, all rights reserved. 2017 ©

Inngangur

Íslandsbanki er að ráðast í breytingar á kortaútgáfu sinni, sem felur í sér að öllum VISA kortum hjá Íslandsbanka verður skipt út fyrir MasterCard kort. Þetta hefur áhrif á seljendur sem senda inn boðgreiðslur og eru með MasterCard viðskipti hjá Borgun en VISA viðskipti annars staðar. Borgun hefur útbúið vefþjónustu til þess að skipta þessum VISA kortanúmerum út fyrir ný MasterCard kortnúmer, svokallaða ReplacementCard þjónustu.

Ef einhverjar spurningar vakna vinsamlega hafið samband við Fyrirtækjasvið Borgunar, replacement@borgun.is.

Hugtök

Sýndarnúmer: Sýndarnúmer er löglegt kortanúmer sem stenst villuprófanir og virkar í boðgreiðslukerfum Borgunar. Ekki er hægt að nota sýndarnúmerin annar staðar. Valitor býður sambærilega þjónustu.

#Aðgangur# Hægt er að nota sama vefþjónustunotanda og er notaður að boðgreiðsluþjónustum (PaymentUpload service eða RecurringPayment service). Sé óskað eftir nýjum aðgangi skal hafa samband við fyrirtækjaþjónustu Borgunar.

Vefþjónustan

##Þjónustuköll##

Þjónustukall Skilar Lýsing
ReplacementCardXmlList Streng Tekur við kortnúmerum á XML formi og skilar ReplacementCard lista í formi XML strengs til baka.
Sjá dæmi um XML strengi neðar.
Athugið að raunkortanúmerin í listanum eru möskuð, til að fá fullt kortanúmer er kallað í FindReplacementCard eða FindReplacementCardById.
Sýnarnúmerum er skilað ómöskuðum.
ReplacementCardList List<ReplacementCard> Skilar lista af nýjum kortnúmerum fyrir seljanda.
Athugið að raunkortanúmerin í listanum eru möskuð, til að fá fullt kortanúmer er kallað í FindReplacementCard eða FindReplacementCardById.
Sýnarnúmerum er skilað ómöskuðum.
FindReplacementCard ReplacementCard Tekur við kortnúmeri, ef nýtt kortnúmer finnst er því skilað.
ReplacementCard færsla merkist skoðuð (viewed) eftir þessa aðgerð.
FindReplacementCardById ReplacementCard Skilar upplýsingum um nýtt kort eftir einkvæmum lykli færslu. Þessu númeri er skilað í ReplacementCardList.
ReplacementCard færsla merkist skoðuð (viewed) eftir þessa aðgerð.

Objects

ResultStatus object

Hvert þjónustukall tekur inn ResultStatus færibreytur sem, eftir keyrslu, inniheldur keyrsluniðurstöðu vefþjónustukallsins. Sjálfum gögnunum er skilað ýmist sem XML streng eða object lista.

ResultCode ResultText ErrorMessage
0 Success NULL
10 Informational e.g. User does not have acceess
20 Warning Warning message
30 Error Error message

ReplacementCard object

Field Type Description
Id String Einkvæmur lykill á færslu
OldCardnumber String Kortnúmer á skrá hjá seljanda
NewCardnumber String Nýtt kortnúmer
MerchantNumber String Samningsnúmer seljanda hjá Borgun, byrjar á 9
Activation DateTime Tímasetning á virkjun nýs kortnúmers
Viewed Bool Gefur til kynna hvort búið sé að fletta kortnúmeri upp áður

Kóðadæmi

static void Main(string[] args)
{
    string username = "user";
    string password = "password";
    bool virtualNumber = false;

    ReplacementCardServiceClient client = new ReplacementCardServiceClient();
    client.ClientCredentials.UserName.UserName = username;
    client.ClientCredentials.UserName.Password = password;
    rcs.ResultStatus status;
    rcs.ReplacementCard card = client.FindReplacementCard(
        "9111111",          // merchant number
        "4501000000000001", // old card number
        virtualNumber,      // virtual number flag
        out status);        // reports the result of the call

    if (status.ResultCode == "0")
    {
        Console.WriteLine(
            "{0} has been replaced with {1}",
            card.OldCardnumber,
            card.NewCardnumber);
    }
    // Always close the client
    client.Close();
}

##XML listar## Fyrir XML samskiptin er klasanum ReplacementCard varpað í XML með rótartaginu . Þegar sendur er inn listi af kortum er nóg að fylla út tagið OldCardnumber. Gætið að hástöfum og lágstöfum. Dæmi um inntak

45010000000000014155000000000008

Dæmi um úttak

<?xml version="1.0" encoding="utf-16" ?>
<ArrayOfReplacementCard xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <ReplacementCard>
       <Id>6</Id>
       <OldCardnumber>450100******0001</OldCardnumber>
       <NewCardnumber>540100******0008</NewCardnumber>
       <MerchantNumber>9111111</MerchantNumber>
       <Activation>2015-01-01T22:10:08</Activation>
       <Viewed>true</Viewed>
    </ReplacementCard>
    <ReplacementCard>
       <Id>11</Id>
       <OldCardnumber>415500******0008</OldCardnumber>
       <NewCardnumber>540100******0001</NewCardnumber>
       <MerchantNumber>9111111</MerchantNumber>
       <Activation>2015-01-02T13:05:48</Activation>
       <Viewed>false</Viewed>
    </ReplacementCard>
</ArrayOfReplacementCard>