Saltar al contingut principal
Utilitza un compte de client quan el client sigui propietari del punt final. Utilitza un destinatari i una destinació quan una altra persona o negoci rebi els fons. El destinatari registra qui rep els fons. La destinació registra on els rep.

​
1. Crea el destinatari

Crea un individu o negoci amb POST /v3/customers/{customerId}/recipients. Envia aquestes capçaleres:
Request headers
Request body
relationship descriu la relació del destinatari amb el teu client. Tria un valor de l’esquema de la sol·licitud POST /v3/customers/{customerId}/recipients. Si envies other, no afegeixis cap camp de text lliure. Swipelux ignora els camps que l’esquema de la sol·licitud no defineix, així que el text no es desaria. Inclou l’adreça abans de crear una destinació fiat. Emmagatzema el data.id del destinatari retornat com a RECIPIENT_ID i conserva el seu estat actual.

​
2. Afegeix una destinació

Crea el punt final amb POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Utilitza una nova clau per a aquesta destinació prevista:
Request headers
Les destinacions Pix i Pix Safe reben BRL i necessiten la capacitat Pix preparada del client (pix_pooled). Una destinació Pix paga a una clau Pix: un CPF o CNPJ només amb dígits, un número de telèfon com a +55 seguit de 10 o 11 dígits, un correu electrònic o una clau aleatòria. Una destinació Pix Safe paga a un compte bancari brasiler identificat pel CPF o CNPJ del titular a taxId, el codi ISPB de 8 dígits del banc a bankCode, la sucursal i el número de compte amb el seu dígit de control. Les respostes i els webhooks retornen taxId emmascarat excepte els seus últims quatre dígits. Swipelux valida els identificadors bancaris, com ara IBAN, BIC, números de ruta ABA i números de CPF o CNPJ, incloses les sumes de control, quan crees una destinació bancària. Els valors mal formats retornen 400 validation_error. Aquestes comprovacions només confirmen el format, no que el compte existeixi ni qui n’és el titular. Utilitza self_custodied només quan el destinatari controli la cartera. Segueix la variant actual de la referència de l’API quan la cartera estigui en mans d’un altre custodi. Emmagatzema el data.id de la destinació retornada com a DESTINATION_ID i conserva el seu estat actual.

​
3. Espera la preparació de la destinació

Llegeix GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} abans de crear una cotització. Continua només quan l’estat actual de la destinació permeti el pagament i la seva moneda, mètode i xarxa coincideixin amb el moviment previst. Els estats del destinatari i de la destinació són independents. Utilitza l’ID de destinació dst_ a la cotització del pagament. L’ID de destinatari rcp_ identifica el registre del propietari i no és una destinació de cotització. A continuació, porta la destinació preparada a Enviar fons.