BitPay is een Amerikaanse aanbieder van bitcoin-betalingsdiensten. Bij het selecteren van BitPay krijgen klanten een factuur voor de transactie te zien. Om verder te gaan, klikt de klant op de bijgeleverde knop om zijn portemonnee te openen en de betaling af te ronden. Eenmaal voltooid, wordt de klant teruggeleid naar uw website en ontvangt u een bevestiging via een URL-kennisgeving.
| Ondersteunde landen | Geen beperkingen voor landen van de klant |
| Ondersteunde munteenheden | EUR, GBP, USD |
| Terugbetalingen |
Restituties worden niet ondersteund. |
| Terugboekingen |
Betalingen zijn niet onderhevig aan terugboekingen. |
| Zero-authorisation |
Niet ondersteund. |
| Terugkerende betalingen |
Niet ondersteund. |
Configuratie
- Neem contact op met uw accountmanager om deze betaalmethode op uw account in te schakelen.
Er wordt een testzandbakaccount verstrekt, die u nodig hebt om uw implementatie te testen. - Wijzig uw POST naar Payment Pages indien nodig:
Naam van het veld Vereist tijdens betaalsessie
(hetzij opgenomen in POST door handelaar of ingevoerd door klant op Payment Pages)
Vereist in POST Beschrijving billingcountryiso2a Ja Geen Het voor het factuuradres ingevoerde land, in ISO2A-formaat. billingfirstname Ja Geen De Voornaam facturatie. billinglastname Ja Geen De Achternaam facturatie. ruleidentifier Geen Geen Als uw POST naar de Payment Pages al alle door de betaalmethode vereiste velden bevat, kunt u het afrekenproces voor de klant stroomlijnen door ook ruleidentifier=STR-14 in te dienen.
Hierdoor kan de browser van de klant onmiddellijk naar de door de betaalmethode gehoste pagina's gaan om de transactie te voltooien. (Wij noemen dit Journey C)
Meldingen
Zodra een betaling is goedgekeurd, worden de middelen op een later tijdstip verrekend, zoals bepaald door BitPay.
De afwikkeling kennisgeving mag niet onmiddellijk na de verwerking van de betaling worden verzonden.
In het onwaarschijnlijke geval dat de betaling na 7 dagen nog steeds in behandeling is afwikkeling (settlestatus "10"), wordt dit ingepland voor onderzoek en nemen wij contact met u op met nadere informatie.
Voordat u begint met testen, raden wij u aan contact op te nemen met ons Support Team en te verzoeken dat regels worden ingeschakeld op uw account, die URL-kennisgevingen naar uw systeem sturen in de volgende scenario's:
- Wanneer een betaling is goedgekeurd.
- Als de fondsen vereffend zijn.
Configuratie van de autorisatie melding
Wij raden u aan ten minste de volgende velden op te nemen in uw autorisatie kennisgeving:
- Antwoordbericht aankoper (acquirerresponsemessage)
- Basisbedrag (baseamount) (b.v. €10,50 is "1050")*.
- Hoofdbedrag (mainamount) (b.v. €10,50 is "10.50")*
- Land facturatie (billingcountryiso2a)
- Munt (currencyiso3a)
- Foutcode (errorcode)
- Live Status (livestatus)
- Referentie bestelling (orderreference)
- Betalingstype (paymenttypedescription)
- Verzoektype (requesttypedescription)
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
- Tijdstempel start transactie (transactionstartedtimestamp)
*Kies uw voorkeursformaat.
Configuratie van de afwikkeling melding
Wij raden u aan de volgende velden op te nemen in uw afwikkeling kennisgeving:
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
Controleer de kennisgeving
U moet de inhoud van elke ontvangen kennisgeving controleren en dienovereenkomstig reageren door de procedures te volgen die in onze URL-kennisgevingen documentatie. In het bijzonder moet u kijken naar de bijgewerkte settlestatus waarde:
- Op autorisatie: Als de settlestatus "0", "1" of "10" is, is de betaling geautoriseerd en hoeft u op dit moment geen verdere actie te ondernemen. Waarden van "2" of "3" geven echter aan dat de fondsen niet gepland voor vereffening (respectievelijk opgeschort en geannuleerd).
- Op afwikkeling: Als de settlestatus is bijgewerkt tot "100", betekent dit dat het geld is vereffend. Als dit is bijgewerkt tot "3", is er een probleem geweest en is de betaling geannuleerd.
Geannuleerde transacties (settlestatus "3") kunnen op een later tijdstip worden afgewikkeld. In situaties waarin de klant de vereiste stappen heeft voltooid om de betaling uit te voeren, wordt de settlestatus wordt bijgewerkt tot "100" om aan te geven dat het geld naar uw rekening is overgemaakt.
Als u contact hebt opgenomen met het Support Team om afwikkeling meldingen te configureren (zoals hierboven beschreven), wordt u op de hoogte gebracht wanneer dit gebeurt.
Test
U moet uw oplossing testen voordat u live betalingen kunt gaan verwerken. Testtransacties worden verwerkt via uw test site referentie.
Vereisten
U moet contact opnemen met ons Support Team en uw BitPay testaccountgegevens doorgeven. Wij zullen dan uw test site referentie configureren om rechtstreeks verbinding te maken met de BitPay testomgeving.
Bij het uitvoeren van testtransacties wordt uw browser omgeleid naar de BitPay testomgeving om een betaling te simuleren. Verder verloopt het proces precies hetzelfde als bij live betalingen.
