Ugrás a fő tartalomhoz
Ügyfélszámlát akkor használjon, amikor az ügyfél tulajdonolja a végpontot. Címzettet és célpontot akkor használjon, amikor egy másik személy vagy vállalkozás fogadja a pénzt. A címzett rögzíti, hogy ki kapja a pénzt. A célpont rögzíti, hogy hol kapják.

​
1. Címzett létrehozása

Hozzon létre egy magánszemélyt vagy vállalkozást a POST /v3/customers/{customerId}/recipients művelettel. Küldje el ezeket a fejléceket:
Request headers
Request body
A relationship a címzett és az ügyfél kapcsolatát írja le. Válasszon értéket a POST /v3/customers/{customerId}/recipients kérési sémából. Ha other értéket küld, ne adjon hozzá szabad szöveges mezőt. A Swipelux figyelmen kívül hagyja a kérési séma által nem definiált mezőket, így a szöveg nem kerülne tárolásra. Adja meg a címet, mielőtt fiat célpontot hoz létre. Tárolja a visszakapott címzett data.id értékét RECIPIENT_ID-ként, és őrizze meg az aktuális státuszát.

​
2. Célpont hozzáadása

Hozza létre a végpontot a POST /v3/customers/{customerId}/recipients/{recipientId}/destinations művelettel. Használjon új kulcsot ehhez a szándékolt célponthoz:
Request headers
A Pix és Pix Safe célpontok BRL-t fogadnak, és az ügyfél kész Pix-képességét (pix_pooled) igénylik. A Pix célpont egy Pix-kulcsra fizet: ez lehet csak számjegyekből álló CPF vagy CNPJ, +55 előtaggal kezdődő, 10 vagy 11 számjegyű telefonszám, e-mail-cím vagy véletlenszerű kulcs. A Pix Safe célpont egy brazil bankszámlára fizet, amelyet a tulajdonos taxId mezőben megadott CPF- vagy CNPJ-száma, a bank bankCode mezőben megadott 8 jegyű ISPB-kódja, a fiók, valamint az ellenőrző számjeggyel együtt megadott számlaszám azonosít. A válaszok és a webhookok a taxId értéket az utolsó négy számjegy kivételével maszkolva adják vissza. A Swipelux banki célpont létrehozásakor ellenőrzi a banki azonosítókat, például az IBAN-okat, a BIC-kódokat, az ABA routing számokat, valamint a CPF- és CNPJ-számokat, az ellenőrző összegekkel együtt. A hibás formátumú értékek 400 validation_error hibát adnak vissza. Ezek az ellenőrzések csak a formátumot igazolják, azt nem, hogy a számla létezik, vagy hogy ki a tulajdonosa. self_custodied értéket csak akkor használjon, ha a címzett irányítja a tárcát. Kövesse az aktuális API referencia változatát, ha a tárcát másik custodian tartja. Tárolja a visszakapott célpont data.id értékét DESTINATION_ID-ként, és őrizze meg az aktuális státuszát.

​
3. Várja meg a célpont készenlétét

Olvassa be a GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} műveletet árajánlat létrehozása előtt. Csak akkor folytassa, ha az aktuális célpont státusza engedi a kifizetést, és annak devizája, módszere és hálózata megfelel a szándékolt mozgásnak. A címzett és a célpont státusza független. Használja a dst_ célpont azonosítót a kifizetési árajánlatban. Az rcp_ címzett azonosító a tulajdonos rekordot jelöli, és nem árajánlat célpont. Ezután vigye a kész célpontot a Pénz küldése oldalra.