Hoe de Upay API-integratie werkt: een complete handleiding voor bedrijven

Uw bedrijf laat geld liggen als u geen cryptobetalingen accepteert. De wereldwijde crypto betalingsgateway De markt, die in 2026 een waarde van 2.39 miljard dollar had, zal naar verwachting in 2030 een waarde van 4.74 miljard dollar bereiken.

Het probleem zit hem echter niet in de vraag, maar in de implementatie. De meeste bedrijven weten niet waar ze moeten beginnen. Dat is waar de Upay API-integratie van pas komt.

Upay biedt bedrijven een overzichtelijke en ontwikkelaarsvriendelijke manier om cryptobetalingen te accepteren, kaarten met hun eigen logo uit te geven en wereldwijd uitbetalingen te versturen, zonder dat ze een betaalinfrastructuur helemaal zelf hoeven op te bouwen.

Key Takeaways

• Dankzij de Upay API-integratie kunnen bedrijven cryptobetalingen accepteren, kaarten met hun eigen logo uitgeven en uitbetalingen versturen zonder zelf een betaalinfrastructuur op te bouwen.
• Het integratieproces bestaat uit verschillende stappen: registreren, de documentatie lezen, een sandbox instellen, API-sleutels genereren, je eerste verzoek indienen, webhooks configureren en live gaan.
• Elke Upay API-aanvraag vereist IP-whitelisting, vier aangepaste headers en een cryptografische handtekening die 60 seconden geldig is.
• De sandbox-omgeving is beschikbaar voor alle partners en stelt u in staat om veilig te testen voordat u live gaat.
  

Lees ook: Beste cryptokaarten met Apple Pay- en Google Pay-ondersteuning

Wat is Upay?

Upay, opgericht in 2023, is een wereldwijd platform voor cryptobetalingen dat is ontworpen om geld te verplaatsen, niet alleen om het op te slaan. Waar veel aanbieders zich uitsluitend richten op wallets of exchanges, combineert Upay betalingsinfrastructuur, kaartuitgifte, acceptatie van cryptovaluta en uitbetalingsmogelijkheden in één ecosysteem, ontworpen voor zowel consumenten als bedrijven.

Het bedrijf opereert via twee verschillende platforms. Het consumentenaanbod is beschikbaar via Upay.bestHet platform biedt gebruikers een cryptowallet en aan crypto gekoppelde betaalkaarten voor het wereldwijd uitgeven van digitale activa. 

Op zakelijk vlak, business.upay.com Biedt een bedrijfsbrede infrastructuur waarmee bedrijven cryptocurrency-betalingen kunnen accepteren, Visa-kaarten met hun eigen merk kunnen lanceren via de white-labeloplossing, wallets kunnen beheren en bulkuitbetalingen kunnen automatiseren via een uniforme API.

Wat Upay onderscheidt, is de focus op betalingen. In plaats van losstaande cryptodiensten aan te bieden, levert het een complete financiële infrastructuur die bedrijven helpt de kloof tussen blockchain en traditionele financiën te overbruggen.

Via één enkele integratie kunnen bedrijven crypto accepteren, geld omzetten en geld uitgeven. kaarts, het naleven van regelgeving beheren en betalingen wereldwijd afhandelen.

Veiligheid en compliance staan ​​centraal in het platform. Upay heeft een vergunning in Dubai en werkt samen met beveiligingspartner SlowMist, afwikkelingspartner StraitsX, KYC-partner Sumsub en Tencent Cloud voor de infrastructuur.

Dit is een platform dat compliance vooropstelt en is ontwikkeld voor bedrijven die veilige, schaalbare en gereguleerde betaaloplossingen nodig hebben voor hun wereldwijde activiteiten.

Wat is een API en waarom is die belangrijk voor betalingen?

Bron: business.upay.com

Een API (Application Programming Interface) is een brug tussen twee softwaresystemen. Hiermee kan uw website of app communiceren met een ander platform en automatisch informatie uitwisselen.

Zie het als een bestelsysteem in een restaurant: je vertelt de ober wat je wilt bestellen. De ober gaat naar de keuken, waar het eten wordt bereid en naar je teruggebracht. Je ziet de keuken nooit. 

An API Het werkt op dezelfde manier. Je website verstuurt een verzoek, het systeem van Upay verwerkt dit en stuurt een reactie terug. Je klant ziet nooit iets van wat er achter de schermen gebeurt.

Zonder een API zou het accepteren van cryptovaluta vereisen dat je je eigen systeem beheert. blockchain node, het handmatig monitoren van inkomende transacties, het afhandelen van valutaconversies en het bouwen van je eigen beveiligingslaag.

Dat vergt maandenlange ontwikkeling. Met de Upay API-integratie hoeft u echter maar één keer verbinding te maken en het platform regelt de rest.

Lees ook: Coin Ticker: De drie letters die een heel cryptoproject vertegenwoordigen.

Wat je kunt doen met de Upay API-integratie

De Upay Business API omvat diverse kernfunctionaliteiten en is te bekijken op https://upay-api.readme.io/reference/api-list.

Acceptatie van cryptobetalingen (Acquirer API)

Maak het voor uw bedrijf mogelijk om wereldwijd cryptobetalingen van klanten te accepteren met een soepele betalingsinfrastructuur.

De Acquirer API genereert unieke walletadressen voor elke transactie, waardoor u betalingen nauwkeurig kunt volgen en de afstemming kunt automatiseren. 

Het biedt ook de mogelijkheid om bestellingen aan te maken en te beheren, terugbetalingen te verwerken en transacties indien nodig te annuleren. Dit geeft verkopers volledige controle over de betalingscyclus en vereenvoudigt de acceptatie van cryptovaluta op grote schaal.

Kaartuitgifte (Kaart-API)

Lanceer virtuele en fysieke betaalkaarten met uw eigen merknaam zonder de infrastructuur helemaal zelf te hoeven opbouwen. Met de Card API kunt u kaarten aan klanten uitgeven en elke fase van de kaartlevenscyclus beheren, van activering en financiering tot blokkeren, ontgrendelen en annuleren. 

UPay verzorgt via haar white-labeloplossing de productie, afhandeling en levering van de kaarten, waardoor bedrijven een volledig gepersonaliseerd kaartprogramma kunnen aanbieden met minimale operationele kosten.

Cryptowalletbeheer (Wallet API)

Integreer veilige cryptowalletfunctionaliteit rechtstreeks in uw platform. De Wallet API stelt bedrijven in staat om walletadressen te genereren en te beheren, stortingen te monitoren, opnames te verwerken en digitale activa efficiënt te verplaatsen. 

Geïntegreerde AML-controles helpen bij het screenen van inkomende transacties en ondersteunen de naleving van wet- en regelgeving, waardoor het een ideale oplossing is voor beurzen, fintechplatforms en applicaties die namens gebruikers geld beheren.

Uitbetalingen (Outlay API)

Automatiseer cryptobetalingen aan particulieren of bedrijven overal ter wereld. De Outlay API stelt platforms in staat om snel en efficiënt geld over te maken naar externe walletadressen, of het nu gaat om salarisbetalingen, freelancers, affiliatecommissies, beloningsprogramma's of massale uitbetalingen. 

Het is ontworpen voor transacties met een hoog volume en stroomlijnt betalingsprocessen, terwijl het de complexiteit van het beheren van grootschalige cryptotransfers vermindert.

Hoe de Upay API-integratie stap voor stap werkt

Hieronder leggen we uit hoe de Upay API-integratie werkt, van aanmelding tot uw eerste live transactie.

Stap 1: Aanmelden en KYC voltooien

Bron: business.upay.com

Allereerst moet u rechtstreeks contact opnemen met hun commerciële team via de Upay-website om toegang te vragen tot hun schaalbare B2B-infrastructuur en API-tools.

Zodra je op de webpagina bent, scroll je naar beneden naar 'Partner met ons' en klik je op het tabblad. De pagina die je ziet, zoals in de afbeelding hierboven, wordt geopend; vul de vereiste informatie in onder het gedeelte 'Aanvraag', selecteer het tabblad 'API-integratie' en klik op het tabblad 'Vraag een gratis demo aan'.

Zodra het Upay-team contact met u opneemt, kunt u Upay downloaden via de website, de Apple Store of de Google Play Store en een zakelijk account aanmaken. 

Voordat u toegang krijgt tot de API, moet u uw identiteit verifiëren (KYC). Dit is standaard voor elk gereguleerd betaalplatform en beschermt zowel u als uw klanten.

Stap 2: Lees de ontwikkelaarsdocumentatie

Elke API wordt geleverd met documentatie die als handleiding fungeert. Hierin worden de beschikbare eindpunten uitgelegd, welke gegevens verzonden moeten worden en wat er terug verwacht kan worden.

Lees de documentatie voordat je ook maar één regel code schrijft. Upay biedt volledige API-documentatie via hun ontwikkelaarsportaal op https://upay-api-en.readme.io.

Stap 3: Verkrijg de openbare sleutel/API-sleutel/geheime sleutel van het platform.

Bron: upay-api-en.readme.io

U kunt de openbare API-sleutel/API-sleutel/geheime sleutel van het platform verkrijgen via uw verkopersdashboard. Een API-sleutel is een lange reeks tekens die fungeert als wachtwoord voor uw account bij de communicatie met het Upay-systeem.

• API-sleutel: Verstrekt door UPay, een unieke identificatiecode voor de handelaar.
• Geheime sleutel: Wordt gebruikt voor het ondertekenen van gegevens bij het aanvragen van de API.
• Publieke platformsleutel: verstrekt door UPay, gebruikt voor het versleutelen van parameters bij het aanvragen van de API.
• Platform privésleutel: Wordt door UPay gebruikt om de parameters te decoderen na ontvangst van het API-verzoek, zodat de oorspronkelijke gegevens worden verkregen.

Voorbeeld: 

—–BEGIN PUBLIEKE SLEUTEL—–

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2r69mrDofiNPIAKNRV5v

BeVBjEnrYPgKf8LKDK+gLhLrepuTc+gxlJurH/gYwgRwD8DL5rmdcXRZMpX+L8gx

yszzD0qFWnBoumN1RHx2kkok1vgLr/dBlJRwVPZbZT69m/B8kGWR8JboBVOWJwxn

DX6WaRDyWVa2qu1KogQq4m028gJWZlVzs0bSExQqSW5ZiUFGyJygjTa2XAKqceSe

xHov8jR66mpnv0vJy6+4YJK34t2VzyNdEqseTE3spZkSJCzzxNV7xIs63u/WTenK

J1BWar+/rA63A+/0Lt2BB/Uf/iq0OwGm4t2d0Pf1O7hylXXP65BGunWvu0QWCsNo

xQIDAQAB

—–EINDE PUBLIEKE SLEUTEL—–

Belangrijk: Plaats uw API-sleutel nooit rechtstreeks in de front-endcode van uw website. Bewaar deze veilig op uw server, want iedereen die de sleutel vindt, kan namens u verzoeken indienen.

Stap 4: Configureer de openbare sleutel van de handelaar

Bron: upay-api-en.readme.io

openbare sleutel van de handelaarDe handelaar configureert de gegenereerde publieke sleutel voor het handelaarsplatform. Als een API-verzoek versleuteld is, zullen de responsgegevens zeker ook versleuteld zijn.

UPay versleutelt de responsgegevens met behulp van de openbare sleutel van de handelaar.

privésleutel van de handelaarNadat de handelaar de API-responsgegevens heeft ontvangen, decodeert hij deze met behulp van zijn privésleutel om de oorspronkelijke responsgegevens terug te krijgen.

Stap 5: Maak een API voor betalingsverzoeken aan

Wanneer een klant ervoor kiest om met crypto te betalen, stuurt uw backend een verzoek naar de Upay API. Het verzoek vertelt Upay: Een klant wil betalen. Genereer een betaaladres.

POST /v2/payments/addresses

{ “chain”: “ETH”, “asset”: “USDT”, “label”: “order_00245”, “callback_url”: “https://yourshop.com/webhooks/crypto” }

Reactie: { “adres”: “0x742d35Cc6634C0532925a3b844Bc…”, “activa”: “USDT”, “aangemaakt op”: “2026-05-18T10:30:00Z” }

Hieronder ziet u hoe dat verzoek er in eenvoudige bewoordingen uitziet:

• Wat je verstuurt: Het bedrag, de valuta (bijv. USDT) en een callback-URL (uw webhook-eindpunt).
• Wat je ervoor terugkrijgt: Een uniek walletadres en een QR-code die de klant kan scannen.
  

Elke order krijgt een eigen, uniek walletadres. Dit voorkomt overlappingen tussen transacties en vereenvoudigt de afstemming.

Stap 6: Webhooks instellen

Een webhook is een automatische notificatie die Upay naar uw server stuurt wanneer een betaling op de blockchain is bevestigd.

In plaats van dat uw systeem steeds vraagt: "Is de betaling aangekomen?", laat Upay u dat direct weten zodra dat het geval is. Zie het als een bezorgmelding van een koerier.

Je hoeft de trackingpagina niet constant te vernieuwen; je wacht op het sms-bericht. Wanneer de webhook binnenkomt, werkt je systeem de orderstatus bij, stuurt de klant een bevestiging en activeert de volgende stap in je orderverwerkingsproces.

Lees ook: Wat betekent 5x in de cryptowereld?

Stap 7: Stel een whitelist van IP-adressen in.

Bron: upay-api-en.readme.io

Beperk de toegang tot de API door de IP-adressen op te geven die verbinding mogen maken. Als er geen IP-adressen zijn geconfigureerd, accepteert de API standaard verzoeken van alle IP-adressen.

Je kunt meerdere IP-adressen op de whitelist zetten door ze met komma's te scheiden.

Voorbeeld : 127.0.0.1, 127.0.0.2

Stap 8: Stel je sandboxomgeving in

Een sandbox is een testomgeving waar geen echt geld in omgaat. Het is een exacte nabootsing van het live systeem. De testomgeving van Upay is beschikbaar op [link]. https://openapi.upay-test.best en is vanaf dag één toegankelijk voor alle partners. 

Gebruik de sandbox om betalingen te simuleren, webhook-notificaties te activeren en te testen hoe uw systeem omgaat met mislukte of gedeeltelijke betalingen. Deze stap is erg belangrijk, dus sla hem niet over.

Stap 9: Ga live

Zodra alles is getest en geverifieerd, schakelt u over van de sandboxmodus naar de livemodus met behulp van uw productie-API-sleutel. Upay deelt de inloggegevens voor de productieomgeving direct met goedgekeurde partners na de onboarding-beoordeling. Echte betalingen kunnen nu via uw systeem verlopen.

UPay API-omgeving 

UPay biedt aparte sandbox- en productieomgevingen, zodat ontwikkelaars integraties veilig kunnen testen voordat ze live gaan. Bouw en valideer je betaalprocessen in de sandbox en schakel vervolgens over naar de productieomgeving wanneer je klaar bent om echte transacties te verwerken.

Milieu	URL	Beschrijving
Test	https://openapi.upay-test.best	Beschikbaar voor alle partners om hun integratie te bouwen en te testen.
STG (Stadiëring)	Momenteel niet beschikbaar	NB
Productie	Niet openbaar gemaakt	De live-modusomgeving wordt aangeboden door Upay.

Upay API-beveiliging: Toegangsvoorwaarden en -beperkingen

Elke API-aanvraag aan Upay moet aan vier beveiligingsvereisten voldoen.

Veiligheidsfactor	Wat het doet	Nodig
IP Whitelisting	Het IP-adres van uw server moet bij Upay geregistreerd zijn voordat verzoeken worden geaccepteerd.	Waar
Reactie IP-verificatie	Uw systeem accepteert alleen reacties van het geverifieerde IP-adres van Upay.	Waar
Webhook-terugbelverzoeken	Sommige transacties vereisen een tweede bevestiging via een webhook.	Niet waar
Handtekeningvenster van 60 seconden	Elk ondertekend verzoek vervalt na 60 seconden om replay-aanvallen te voorkomen.	Ja

Het tijdsvenster van 60 seconden is cruciaal. Een replay-aanval is een aanval waarbij iemand een geldig verzoek onderschept en later probeert opnieuw te verzenden.

Het venster voor de handtekening voorkomt dit. Zorg ervoor dat de klok van uw server is gesynchroniseerd met NTP (Network Time Protocol) voordat u begint met de integratie.

Upay API-verzoek-/antwoordheaders

Elke aanvraag/reactie vereist vier aangepaste HTTP-headers. Deze headers werken samen om te verifiëren dat elke aanvraag authentiek, tijdig en afkomstig van het juiste account is.

• X-UPA-APIKEY: Dit is uw unieke API-sleutel, toegewezen door UPay. Alleen degenen die deze sleutel bezitten, hebben toegang tot het uitvoeren van API-aanroepen.
• X-UPA-REQUESTID: Een unieke ID voor elk verzoek om dubbele verwerking te voorkomen.
• X-UPA-TIJDSTEMPEL: De huidige tijdstempel in milliseconden
• X-UPA-SIGN: Een cryptografische handtekening die bewijst dat het verzoek niet is gewijzigd.
  

Verzoek headers

Veld	Data type	Uitleg	Effect
X-UPA-APIKEY	Draad	Verzoek om API-sleutel	Identificeer en onderscheid white-label gebruikers
X-UPA-REQUESTID	Draad	Verzoek om een ​​unieke code	Verzoek om idempotentie
X-UPA-TIJDSTEMPEL	Draad	Tijdstempel in milliseconden	Vraagtijd; als er binnen 60 seconden geen reactie komt, treedt er een time-out op en wordt er niet meer op dit verzoek gereageerd. Voorkom replay-aanvallen.
X-UPA-SIGN	Draad	Signature	Handtekening ter verificatie van de authenticiteit en juistheid van de aanvrager.

Response Headers

Veld	Data type	Uitleg
X-UPA-REQUESTID	Draad	Vraag om een ​​unieke code die identiek is aan de aanvraag-ID om consistentie in het antwoord te garanderen.
X-UPA-TIJDSTEMPEL	Draad	Reactietijdstempel, tijdstempel, milliseconden

Een praktijkvoorbeeld van Upay API-integratie in actie.

Tunde, een in Lagos gevestigde handelaar in digitale goederen, verkoopt aan klanten in Nigeria, het Verenigd Koninkrijk, Canada en de Verenigde Arabische Emiraten. Voorheen duurden internationale bankoverschrijvingen vaak meerdere werkdagen voordat ze verwerkt waren en brachten ze hoge kosten met zich mee voor valutaconversie.

Nadat hij de Upay API in zijn afrekenproces had geïntegreerd, verliepen betalingen vrijwel direct. Wanneer een klant in Toronto 'Betalen met crypto' selecteert, stuurt Tunde's systeem een ​​verzoek naar Upay, dat een uniek USDT-betaaladres en een QR-code genereert. 

De klant voltooit de betaling vanuit zijn of haar digitale portemonnee, waarna Upay de transactie automatisch controleert en verifieert op de blockchain. Zodra de transactie is bevestigd, stuurt een webhook een melding naar het platform van Tunde, waarna de orderverwerking en levering worden geactiveerd.

Het hele proces duurt minder dan twee minuten, waardoor vertragingen bij de bank worden geëlimineerd en onnodige betalingskosten worden verlaagd. Volgens Eigendomsgegevens van Triple-AHet aantal mensen dat wereldwijd cryptovaluta bezit, bereikte in 2024 ongeveer 562 miljoen, een stijging van 34% ten opzichte van 420 miljoen het jaar ervoor. 

Die groei is precies de reden waarom steeds meer bedrijven zoals dat van Tunde een cryptobetaaloptie toevoegen in plaats van het als een nichefunctie te beschouwen, en UPay levert dit op wereldwijde schaal.

Waarom bedrijven voor Upay kiezen

Als u cryptobetalingen wilt integreren zonder technische complexiteit, biedt UPay een praktische en schaalbare oplossing.

API biedt handelaars meerdere activa, white-label kaartbranding en meer, met directe afwikkeling en automatische crypto-naar-fiat-conversie. 

Met registraties bij regelgevende instanties in de VS, Canada, Hong Kong en de VAE, biedt UPay de beveiliging, naleving van regelgeving en wereldwijde reikwijdte die nodig zijn om moderne cryptobetalingen te stroomlijnen en groei op lange termijn te ondersteunen.