Pénz küldése

Minden kifizetés egy kész, feltöltött kibocsátott tárcából indul. A célpontmodell attól függ, ki tulajdonolja a végpontot.

Mielőtt kezdi

Frissítse le a forrás tárcát. Erősítse meg, hogy az aktuális státusza engedi a kifizetést és a rendelkezésre álló egyenlege fedezi a szándékolt forrásösszeget. Tárolja a válaszból származó azonosítót SOURCE_WALLET_ID-ként. Szüksége van egy kész kifizetési képességre is az aktuális ügyfélhez és kiválasztott célponthoz.

1. A célpont előkészítése

Saját tulajdonú
Harmadik fél

Használjon egy ügyfél tulajdonában lévő külső bankszámlát, amikor az ügyfél tulajdonolja a végpontot. Hozza létre a POST /v3/customers/{customerId}/accounts művelettel és ezekkel a fejlécekkel:

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

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

Olvassa be a GET /v3/customers/{customerId}/accounts/{accountId} művelettel. Csak akkor folytassa, ha az aktuális státusza engedi a kifizetést. Tárolja a acc_ azonosítót PAYOUT_DESTINATION_ID-ként.

Hozza létre a személyt vagy vállalkozást és a bank- vagy tárca-végpontját a Címzettek és célpontok alapján. Csak akkor folytassa, ha a célpont kész.Tárolja a visszakapott dst_ azonosítót PAYOUT_DESTINATION_ID-ként. Ne használja a címzett rcp_ azonosítóját árajánlat célpontként.

2. A kifizetési árajánlat létrehozása

Használja a POST /v3/quotes műveletet ezekkel a fejlécekkel:

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

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

Tárolja a data.id értéket QUOTE_ID-ként, és jelenítse meg a visszaadott árat és díjakat.

3. A kifizetés végrehajtása

Hozza létre az átutalást a POST /v3/transfers művelettel. Használjon egy új kulcsot ehhez a szándékolt végrehajtáshoz:

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

{
  "quoteId": "${QUOTE_ID}"
}

Tárolja az átutalás data.id értékét TRANSFER_ID-ként. Egy sikeres létrehozás elindítja a kifizetést; nem bizonyítja a kézbesítést.

4. A kézbesítés követése

Olvassa be a GET /v3/transfers/{transferId} műveletet a létrehozás után és minden esemény után. A legfrissebb data.state, data.stateDetail és data.openTaskIds alapján döntse el, hogy vár, cselekszik, vagy végleges kimenetet jelenít meg. Ezután nézze át az Árajánlatok és átutalások oldalt a pontos összegekért, a biztonságos végrehajtási helyreállításért és az átutalási feladatokért.

Kezdő lépések

Ügyfelek beléptetése

Pénzáramlások kiépítése

Élesítés

Mielőtt kezdi

1. A célpont előkészítése

2. A kifizetési árajánlat létrehozása

3. A kifizetés végrehajtása

4. A kézbesítés követése

​Mielőtt kezdi

​1. A célpont előkészítése

​2. A kifizetési árajánlat létrehozása

​3. A kifizetés végrehajtása

​4. A kézbesítés követése

Mielőtt kezdi

1. A célpont előkészítése

2. A kifizetési árajánlat létrehozása

3. A kifizetés végrehajtása

4. A kézbesítés követése