Payment generator

VeilPay ondersteunt twee betaalmethoden:

De directe methode is de eenvoudigste manier om betalingen te ontvangen. Je genereert een betaallink en stuurt die naar de gebruiker. De gebruiker opent de link en voltooit de transactie. Deze methode vereist geen backend-integratie. Omdat de transactieparameters (bedrag, adres, enz.) mogelijk door de gebruiker kunnen worden gewijzigd, moet je altijd controleren of de betaling op het juiste adres is ontvangen voordat je goederen of diensten levert.

De indirecte methode geeft je meer controle over de transactie. In deze flow maak je eerst de transactie aan en ontvang je een transactie-ID. Vervolgens presenteer je de betaalgegevens aan de gebruiker. Omdat de transactie vooraf is aangemaakt, kan de gebruiker de betalingsparameters niet wijzigen. Zo kun je ook de transactiestatus volgen met behulp van het transactie-ID. Transacties die met deze methode zijn aangemaakt, moeten binnen 72 uur worden gestart, anders worden ze automatisch uit de database verwijderd.

Gebruik de vooraf gegenereerde transactiemethode als je wilt:

meer controle over de betaalflow

de mogelijkheid om de transactiestatus te volgen

sterkere bescherming tegen parameterwijzigingen

Gebruik de directe-linkmethode als je wilt:

de snelste integratie

geen backend-ontwikkeling

een eenvoudige betaallinkflow

VeilPay-transacties zijn momenteel beperkt tot het equivalent van 5 BTC per transactie.

Deze limiet helpt verwerkingsvertragingen te minimaliseren en vermindert mogelijke KYC-gerelateerde risico's.

Als de gebruiker dezelfde cryptovaluta stuurt als de valuta die jij hebt geselecteerd om te ontvangen, is geen ruil nodig.

Veil rekent voor deze transacties geen kosten.

Als e-mailmeldingen zijn ingeschakeld bij het aanmaken van een transactie, ontvang je een melding zodra de betaling is voltooid.

VeilPay verwerkt fiat-betalingen niet rechtstreeks.

Je kunt de prijs van een transactie echter wel in fiatvaluta (USD, EUR, enz.) definiëren.

VeilPay zet het bedrag automatisch om naar de equivalente waarde in cryptovaluta tegen de actuele wisselkoers.

De vooraf gegenereerde (indirecte) methode is gebouwd voor server-naar-server-integratie. Je backend maakt een betaling aan via onze REST API, ontvangt een anonpay_id terug, en jij toont of embed de VeilPay-widget met dat id. Alle betaalparameters worden bij ons opgeslagen, zodat de klant het bedrag, adres of enig ander veld niet kan wijzigen.

Alle endpoints bevinden zich onder /api/anonpay op je VeilPay-domein. Ze zijn openbaar — er is geen API-sleutel of ondertekening nodig om een betaling aan te maken.

Stuur vanaf je server een POST-verzoek naar /api/anonpay/prepare met de munt en het netwerk die je wilt ontvangen, je walletadres en het bedrag. Er wordt op dit moment nog geen bestelling aangemaakt — je reserveert alleen een betaalintentie.

Stuur de klant door naar de betaalpagina voor dat id, of embed deze als iframe op je eigen pagina. De widget opent met bedrag en adres vastgezet — de klant kiest alleen met welke munt hij betaalt.

Controleer op elk moment de huidige status met een GET-verzoek. De status doorloopt prepared → waiting_deposit → deposit_received → exchanging → sending → completed.

In plaats van te pollen, geef je bij het aanmaken van de betaling een webhook-URL op om bij elke statuswijziging een POST te ontvangen: