Vai al contenuto principale
Usa un conto cliente quando il cliente possiede l’endpoint. Usa un recipient e una destination quando un’altra persona o azienda riceve i fondi. Il recipient registra chi riceve i fondi. La destination registra dove li riceve.

​
1. Crea il recipient

Crea un individuo o un business con POST /v3/customers/{customerId}/recipients. Invia questi header:
Request headers
Request body
relationship descrive la relazione tra il recipient e il cliente. Scegli un valore dallo schema della richiesta POST /v3/customers/{customerId}/recipients. Se invii other, non aggiungere un campo di testo libero. Swipelux ignora i campi che lo schema della richiesta non definisce, quindi il testo non verrebbe salvato. Includi l’indirizzo prima di creare una destination fiat. Salva il data.id del recipient restituito come RECIPIENT_ID e conserva il suo stato corrente.

​
2. Aggiungi una destination

Crea l’endpoint con POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Usa una nuova chiave per questa destination prevista:
Request headers
Le destination Pix e Pix Safe ricevono BRL e richiedono la capability Pix del cliente in stato ready (pix_pooled). Una destination Pix paga una chiave Pix: un CPF o CNPJ composto solo da cifre, un numero di telefono nel formato +55 seguito da 10 o 11 cifre, un’email o una chiave casuale. Una destination Pix Safe paga un conto bancario brasiliano identificato dal CPF o CNPJ del titolare in taxId, dal codice ISPB a 8 cifre della banca in bankCode, dalla filiale e dal numero di conto con la relativa cifra di controllo. Le risposte e i webhook restituiscono taxId mascherato, ad eccezione delle ultime quattro cifre. Swipelux convalida gli identificativi bancari come IBAN, BIC, routing number ABA e numeri CPF o CNPJ, inclusi i checksum, quando crei una destination bancaria. I valori non validi restituiscono 400 validation_error. Questi controlli confermano solo il formato, non che il conto esista né chi ne sia il titolare. Usa self_custodied solo quando il recipient controlla il wallet. Segui la variante corrente dell’API Reference quando il wallet è detenuto da un altro custode. Salva il data.id della destination restituito come DESTINATION_ID e conserva il suo stato corrente.

​
3. Attendi la readiness della destination

Leggi GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} prima di creare un quote. Prosegui solo quando lo stato corrente della destination consente il payout e la sua valuta, metodo e network corrispondono al movimento previsto. Gli stati di recipient e destination sono indipendenti. Usa l’ID di destination dst_ nel quote di payout. L’ID rcp_ del recipient identifica il record del proprietario e non è una destination di quote. Successivamente, porta la destination ready in Invia fondi.