Recevoir des fonds

Utilisez un encaissement avec devis lorsque le client doit financer un montant spécifique. Le transfert règle en stablecoin dans un portefeuille émis.

Avant de commencer

Vous avez besoin d’une capacité d’encaissement prête et d’un portefeuille de destination émis prêt pour le même client. Complétez toute tâche ouverte via Capacités et tâches, puis récupérez à nouveau les deux ressources.

1. Créer un devis

Créez le prix avec POST /v3/quotes. Envoyez ces en-têtes :

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

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "externalId": "payin-order-123",
  "in": {
    "amount": "150.00",
    "currency": "USD"
  },
  "destinationId": "${SETTLEMENT_WALLET_ID}",
  "out": {
    "currency": "USDC"
  }
}

Stockez data.id en tant que QUOTE_ID. Présentez les montants et les frais renvoyés plutôt que de les reconstruire à partir du taux.

2. Exécuter le devis

Exécutez le devis actuel avant expiration avec POST /v3/transfers. Utilisez une nouvelle clé pour ce transfert prévu :

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

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

Stockez le data.id du transfert en tant que TRANSFER_ID et conservez son état actuel.

3. Récupérer les instructions de financement

Lisez GET /v3/transfers/{transferId}/instructions. Rendez la variante data.instructions renvoyée sans supposer son type. Ces détails sont spécifiques au transfert. Ne réutilisez jamais les coordonnées bancaires, le code, l’URL hébergée, le montant, la référence ou l’expiration d’un transfert pour un autre encaissement. Pour les instructions bancaires, lorsque reference.required est true, affichez exactement la reference.value à côté des coordonnées bancaires et rendez-la copiable. Affichez le montant et la devise renvoyés du même ensemble d’instructions. Un compte bancaire émis est différent : il fournit des coordonnées réutilisables pour les dépôts ultérieurs. Consultez Émettre un compte bancaire lorsque c’est l’expérience prévue.

4. Suivre le règlement

Lisez GET /v3/transfers/{transferId} après l’exécution et après chaque événement. Pilotez le statut destiné au client à partir du dernier data.state. Utilisez data.stateDetail et data.openTaskIds lorsque le transfert nécessite une autre action. Ne le marquez pas comme terminé à partir d’un calendrier prévu. Ensuite, ajoutez des Webhooks et gardez le statut de transfert synchronisé jusqu’à ce qu’il atteigne un résultat que votre produit gère.

Commencer

Intégrer les clients

Construire les flux monétaires

Mise en production

Recevoir des fonds

Avant de commencer

1. Créer un devis

2. Exécuter le devis

3. Récupérer les instructions de financement

4. Suivre le règlement

​Avant de commencer

​1. Créer un devis

​2. Exécuter le devis

​3. Récupérer les instructions de financement

​4. Suivre le règlement

Avant de commencer

1. Créer un devis

2. Exécuter le devis

3. Récupérer les instructions de financement

4. Suivre le règlement