Skip to main content
Gebruik de Transfers API om geld te versturen, ontvangers te vinden die je kunt betalen, overboekingen weer te geven en op te halen bij het afstemmen van geldstromen, en claimlinks te bekijken of in te wisselen. Abonneer je op transfer.completed en transfer.failed voor uitkomsten in plaats van te pollen. Elk deelnemend account kan zich op deze events abonneren. transfer.created wordt ook bij succes verstuurd, niet wanneer de verwerking begint. Een mislukte overboeking kan onder hetzelfde ID opnieuw worden geprobeerd en later alsnog slagen; haal de overboeking op om de huidige status af te stemmen. Een geslaagde saldo-overboeking wordt bijgeschreven op het beschikbare saldo van de ontvanger, tenzij er een vrijgavedatum geldt. Overboekingen die uit een openstaand saldo worden gefinancierd, behouden een vrijgavedatum en worden bijgeschreven op het openstaande saldo; toepasselijke reserves van de ontvanger of fraudeblokkeringen kunnen ervoor zorgen dat geld niet beschikbaar is. succeeded bevestigt dat de overboeking is voltooid, niet dat al het geld kan worden opgenomen.

Endpoints

Attributen

string
vereist
Transfer-ID.
object | null
vereist
Bedrag dat aan de ontvanger is bijgeschreven. Null zolang de overboeking niet is geslaagd.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. "10.00" is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
Valutacode volgens ISO 4217 van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen je moet TONEN. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso’s geschreven, dus het is 2 en 0. Formatteer het getal hiermee in je eigen locale.
string
vereist
Wanneer de overboeking is aangemaakt.
object | null
vereist
Bedrijfsaccount of gebruiker die de overboeking ontvangt.

Eigenschappen

string
vereist
Account- of gebruikers-ID.
string | null
vereist
URL van het bedrijfslogo of de gebruikersavatar. Null als er geen afbeelding beschikbaar is.
string | null
vereist
Weergavenaam van het bedrijf of de gebruiker.
string
vereist
Of het profiel een bedrijfsaccount of een gebruiker is.Beschikbare opties: account, user
string | null
vereist
Vastgelegd tijdstip van mislukking. Null tenzij de overboeking is mislukt.
string | null
vereist
Machineleesbare foutcode. Null tenzij de overboeking is mislukt.
string | null
vereist
Uitleg van de fout. Null tenzij de overboeking is mislukt.
object | null
vereist
Alle toepasselijke transferkosten, inclusief platformopslag. Null als het gezaghebbende totaal niet beschikbaar is.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. "10.00" is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
Valutacode volgens ISO 4217 van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen je moet TONEN. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso’s geschreven, dus het is 2 en 0. Formatteer het getal hiermee in je eigen locale.
object
vereist
Aangepaste metadata die aan de overboeking is gekoppeld.
string | null
vereist
Notitie bij de overboeking.
string
vereist
Het objecttype.
object | null
vereist
Bedrijfsaccount of gebruiker die de overboeking verstuurt.

Eigenschappen

string
vereist
Account- of gebruikers-ID.
string | null
vereist
URL van het bedrijfslogo of de gebruikersavatar. Null als er geen afbeelding beschikbaar is.
string | null
vereist
Weergavenaam van het bedrijf of de gebruiker.
string
vereist
Of het profiel een bedrijfsaccount of een gebruiker is.Beschikbare opties: account, user
string
vereist
Huidige status van de overboeking. Een overboeking kan als processing worden aangemaakt en een paar seconden later worden afgewikkeld; poll Retrieve Transfer of luister naar de webhooks transfer.completed en transfer.failed in plaats van de respons bij het aanmaken als definitief te beschouwen. succeeded en failed zijn definitief.Beschikbare opties: processing, succeeded, failed
string | null
vereist
Vastgelegd tijdstip van de huidige overgang. Null als het historische tijdstip van de overgang onbekend is.
string | null
vereist
Vastgelegd tijdstip van slagen. Null als onbekend.
string
vereist
Trackingpagina voor de overboeking. Om deze te bekijken moet je zijn ingelogd en toegang hebben tot de overboeking.
Transfer