Hopp til hovedinnhold
Bruk en kundekonto når kunden eier endepunktet. Bruk en mottaker og destinasjon når en annen person eller virksomhet mottar midlene. Mottakeren registrerer hvem som mottar midlene. Destinasjonen registrerer hvor de mottar dem.

​
1. Opprett mottakeren

Opprett en individ eller virksomhet med POST /v3/customers/{customerId}/recipients. Send disse headerne:
Request headers
Request body
relationship beskriver mottakerens forhold til kunden. Velg en verdi fra request-skjemaet for POST /v3/customers/{customerId}/recipients. Hvis du sender other, skal du ikke legge til et fritekstfelt. Swipelux ignorerer felt som request-skjemaet ikke definerer, så teksten ville ikke blitt lagret. Inkluder adressen før du oppretter en fiat-destinasjon. Lagre den returnerte mottaker-data.id som RECIPIENT_ID og behold gjeldende status.

​
2. Legg til en destinasjon

Opprett endepunktet med POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Bruk en ny nøkkel for denne tiltenkte destinasjonen:
Request headers
Pix- og Pix Safe-destinasjoner mottar BRL og krever kundens klare Pix-capability (pix_pooled). En Pix-destinasjon betaler til en Pix-nøkkel: et CPF- eller CNPJ-nummer med bare sifre, et telefonnummer som +55 etterfulgt av 10 eller 11 sifre, en e-postadresse eller en tilfeldig nøkkel. En Pix Safe-destinasjon betaler til en brasiliansk bankkonto som identifiseres med innehaverens CPF eller CNPJ i taxId, bankens 8-sifrede ISPB-kode i bankCode, filialen og kontonummeret med kontrollsiffer. Responser og webhooks returnerer taxId maskert til de fire siste sifrene. Swipelux validerer bankidentifikatorer som IBAN-er, BIC-er, ABA-routingnumre og CPF- eller CNPJ-numre, inkludert kontrollsummer, når du oppretter en bankdestinasjon. Ugyldige verdier returnerer 400 validation_error. Disse kontrollene bekrefter bare formatet, ikke at kontoen finnes eller hvem som eier den. Bruk self_custodied kun når mottakeren kontrollerer lommeboken. Følg gjeldende variant i API-referansen når lommeboken holdes av en annen depotforvalter. Lagre den returnerte destinasjons-data.id som DESTINATION_ID og behold gjeldende status.

​
3. Vent på destinasjonsklarhet

Les GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} før du oppretter et tilbud. Fortsett kun når gjeldende destinasjonsstatus tillater payout-en, og valutaen, metoden og nettverket samsvarer med den tiltenkte bevegelsen. Statusen til mottaker og destinasjon er uavhengige. Bruk dst_-destinasjons-ID-en i payout-tilbudet. rcp_-mottaker-ID-en identifiserer eieroppføringen og er ikke en tilbudsdestinasjon. Deretter, ta den klare destinasjonen til Send midler.