Saņēmēji un galamērķi

Izmantojiet klienta kontu, ja klients ir galapunkta īpašnieks. Izmantojiet saņēmēju un galamērķi, ja līdzekļus saņem cita persona vai uzņēmums. Saņēmējs reģistrē, kurš saņem līdzekļus. Galamērķis reģistrē, kur viņš tos saņem.

1. Izveidojiet saņēmēju

Izveidojiet privātpersonu vai uzņēmumu ar POST /v3/customers/{customerId}/recipients. Nosūtiet šīs galvenes:

Request headers

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-create-001
Content-Type: application/json

Request body

{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@example.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}

relationship apraksta saņēmēja saistību ar jūsu klientu. Izvēlieties vērtību no POST /v3/customers/{customerId}/recipients pieprasījuma shēmas. Ja sūtāt other, nepievienojiet brīvā teksta lauku. Swipelux ignorē laukus, ko pieprasījuma shēma nedefinē, tāpēc teksts netiktu saglabāts. Pirms fiat galamērķa izveides iekļaujiet adresi. Saglabājiet atgriezto saņēmēja data.id kā RECIPIENT_ID un saglabājiet tā pašreizējo statusu.

2. Pievienojiet galamērķi

Izveidojiet galapunktu ar POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Izmantojiet jaunu atslēgu šim paredzētajam galamērķim:

Request headers

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json

Bankas galamērķis
Pix galamērķis
Pix Safe galamērķis
Maka galamērķis

{
  "type": "ach",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Jason Swipelux",
    "country": "US"
  }
}

{
  "type": "pix",
  "currency": "BRL",
  "details": {
    "pixKey": "jason@example.com",
    "accountHolderName": "Jason Swipelux"
  }
}

{
  "type": "pix_safe",
  "currency": "BRL",
  "details": {
    "taxId": "52998224725",
    "bankCode": "00000208",
    "branchCode": "0001",
    "accountNumber": "123456-7",
    "accountType": "checking",
    "accountHolderName": "Jason Swipelux"
  }
}

{
  "type": "wallet",
  "currency": "USDC",
  "ownership": {
    "type": "self_custodied"
  },
  "details": {
    "network": "base",
    "address": "0x1111111111111111111111111111111111111111"
  }
}

Pix un Pix Safe galamērķi saņem BRL, un tiem nepieciešama klienta gatava Pix iespēja (pix_pooled). Pix galamērķis izmaksā uz Pix atslēgu: CPF vai CNPJ tikai ar cipariem, tālruņa numuru formātā +55, kam seko 10 vai 11 cipari, e-pasta adresi vai nejaušu atslēgu. Pix Safe galamērķis izmaksā uz Brazīlijas bankas kontu, ko identificē turētāja CPF vai CNPJ laukā taxId, bankas 8 ciparu ISPB kods laukā bankCode, filiāle un konta numurs ar tā kontrolciparu. Atbildes un webhook izsaukumi atgriež taxId maskētu līdz pēdējiem četriem cipariem. Swipelux validē bankas identifikatorus, piemēram, IBAN, BIC, ABA maršrutēšanas numurus un CPF vai CNPJ numurus, tostarp kontrolsummas, kad izveidojat bankas galamērķi. Nepareizi formatētas vērtības atgriež 400 validation_error. Šīs pārbaudes apstiprina tikai formātu, nevis to, ka konts pastāv vai kam tas pieder. Izmantojiet self_custodied tikai tad, kad saņēmējs kontrolē maku. Ja maku tur cits kastodijs, sekojiet pašreizējam API atsauces variantam. Saglabājiet atgriezto galamērķa data.id kā DESTINATION_ID un saglabājiet tā pašreizējo statusu.

3. Gaidiet galamērķa gatavību

Pirms kotācijas izveides nolasiet GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId}. Turpiniet tikai tad, kad pašreizējais galamērķa statuss atļauj izmaksu un tā valūta, metode un tīkls atbilst paredzētajai kustībai. Saņēmēja un galamērķa statusi ir neatkarīgi. Izmantojiet dst_ galamērķa ID izmaksas kotācijā. rcp_ saņēmēja ID identificē īpašnieka ierakstu un nav kotācijas galamērķis. Tālāk aizvediet gatavo galamērķi uz Sūtīt līdzekļus.

Sākt darbu

Klientu iekļaušana

Veidot naudas plūsmas

Palaišana

Saņēmēji un galamērķi

1. Izveidojiet saņēmēju

2. Pievienojiet galamērķi

3. Gaidiet galamērķa gatavību

​1. Izveidojiet saņēmēju

​2. Pievienojiet galamērķi

​3. Gaidiet galamērķa gatavību

1. Izveidojiet saņēmēju

2. Pievienojiet galamērķi

3. Gaidiet galamērķa gatavību