Additional Electronic Payments

Additional Electronic Payments

Elektronisch (bij-) betalen voor handmatige orders of aangepaste orders resulteren in een snellere verwerking van uw orders. Immers worden de orders in Sherpa vrijgegeven op het moment dat een order 100 % elektronisch betaald is of dat de betaling in totaliteit binnen is gekomen via de bank en weer is ingelezen in Sherpa.

In Sherpa zijn er een aantal webmethods ontwikkelt waarmee u zelf elektronische (bij-) betalingen voor uw orders en herinneringen kunt regelen. In uw eigen website ontwikkelt u hiervoor een “betaal-pagina” waarop de gewenste betaalmethode (vb. iDeal, Creditcard etc etc) gekozen kan worden en de pagina regelt verder de communicatie met uw payment provider.

In uw Sherpa omgeving kunnen deze webmethods op verzoek geactiveerd worden. Indien gewenst stuur dan een verzoek naar support@sherpaan.nl. Na het activeren ontvangt u de exacte url en een credentials waarmee u toegang krijgt tot deze specifieke services.

Hieronder worden de webmethods besproken en vind u een technische uitleg van de werking.

Webmethods:


1. DecodePayment
Deze webmethod zorgt ervoor dat de waarde die in de e-mailtemplates wordt geplaatst voor de code [@PAYMENTHASH@] terug te vertalen is naar order gerelateerde gegevens.

Input

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <DecodePayment xmlns="http://sherpa.sherpaan.nl/">
            <webUserLogin>guid</webUserLogin>
            <code>string</code>
        </DecodePayment>
    </soap:Body>
</soap:Envelope>

Field Name
Description
webUserLogin
Gebruiker/Login welke toegang heeft tot deze webmethod.
code
De paymenthash welke in de emailtemplate van Sherpa wordt gegenereerd.

Output

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<DecodePaymentResponse xmlns="http://sherpa.sherpaan.nl/">
<DecodePaymentResult>
<ResponseTime>int</ResponseTime>
<ResponseValue>
<IsElectronicPayment>boolean</IsElectronicPayment>
<OrderNumber>string</OrderNumber>
<Amount>decimal</Amount>
</ResponseValue>
</DecodePaymentResult>
</DecodePaymentResponse>
</soap:Body>
</soap:Envelope>


Field Name
Description
IsElectornicPayment
Als de order in Sherpa een betaalmethode heeft welke een electronische betaalwijze is komt hier True op terug. Op dat moment kan er ook een “AddElectronicPayment” uitgevoerd worden op de betreffende order.
OrderNumber
Het Sherpa ordernummer
Amount
Bedrag dat betaald moet worden

AddElectronicPayment
Deze webmethod regelt het toevoegen en een elektronische (deel) betaling aan een order.

Input

<?xml version="1.0" encoding="utf-8"?>
<soap:Body>
<AddElectronicPayment xmlns="http://sherpa.sherpaan.nl/">
<webUserLogin>guid</webUserLogin>
<ordernumber>string</ordernumber>
<amount>decimal</amount>
<reference>string</reference>
</AddElectronicPayment>
</soap:Body>
</soap:Envelope>


Field Name
Description
webUserLogin
Gebruiker/Login welke toegang heeft tot deze webmethod.
orderNumber
Het Sherpa ordernummer
amount
Bedrag dat elektronisch is afgerekend
reference
Referentie van de betaling

EncodePayment
Met deze webmethod heb je de mogelijkheid om ook zelf een PaymentHash te genereren zoals Sherpa dat doet.

Input

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<EncodePayment xmlns="http://sherpa.sherpaan.nl/">
<webUserLogin>guid</webUserLogin>
<isElectronicPayment>boolean</isElectronicPayment>
<ordernumber>string</ordernumber>
<amount>decimal</amount>
</EncodePayment>
</soap:Body>
</soap:Envelope>


Field Name
Description
webUserLogin
Gebruiker/Login welke toegang heeft tot deze webmethod
isElectronicPayment
True in het geval van een elektronische betaling, anders False.
amount
Het Sherpa ordernummer

Bedrag dat betaald moet worden

Output

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<EncodePaymentResponse xmlns="http://sherpa.sherpaan.nl/">
<EncodePaymentResult>
<ResponseTime>int</ResponseTime>
<ResponseValue>string</ResponseValue>
</EncodePaymentResult>
</EncodePaymentResponse>
</soap:Body>
</soap:Envelope>

Field Name
Description
ResponseValue
De webmethod geeft de payment hash terug




    • Related Articles

    • Werking van basis API's in Sherpa

      Hieronder staan enkele van de meest gebruikte Sherpa web methodes beschreven. Via support@sherpaan.nl kun je de API url opvragen voor jullie Sherpa omgeving. Ook kun je daar je daar het security token opvragen, welke je bij elke call moet mee geven. ...