Wooshpay est en mesure d'effectuer des paiements sur votre compte bancaire. Vous pouvez consulter la liste de tous vos paiements sur votre compte bancaire dans le tableau de bord. Vous pouvez également récupérer la liste des paiements par API.

Statut du paiement #

Il existe cinq états pour une demande de paiement. Une fois le paiement créé, l'état initial est en attente. Lorsque l'API d'annulation est appelée, l'état est annulé, ce qui entraîne l'annulation du processus de paiement. Lorsque la demande est soumise à la banque, l'état devient in_transit. Il se décompose ensuite en deux possibilités : si le traitement bancaire échoue, le résultat du paiement sera "Failed" ; si le traitement bancaire réussit, le statut sera "paid".

Vitesse de paiement #

Alors que le calendrier des paiements fait référence à la cadence à laquelle vos fonds sont payés (par exemple, le jour de la semaine), la vitesse de paiement fait référence au temps qu'il faut pour que vos fonds deviennent disponibles. La vitesse de paiement varie selon les pays et est généralement exprimée en T+X jours. Certains processeurs de paiement peuvent faire débuter le "T" par leur délai de règlement interne, c'est-à-dire le moment où les fonds arrivent sur leurs comptes bancaires.

"T" désigne l'heure de la transaction, c'est-à-dire l'heure de la confirmation ou de la saisie du paiement initial. Par exemple, si votre compte est basé dans un pays où la vitesse de paiement standard est de T+3 et que vous êtes sur un calendrier de paiement manuel, votre solde sera disponible pour le paiement dans les 3 jours ouvrables à partir du moment où vous avez capturé un paiement.

Montant minimum du paiement #

Le montant du paiement minimum est généralement une unité de base de la monnaie locale. Par exemple, aux États-Unis, le paiement minimum est d'un dollar américain, tandis qu'à Singapour, il est d'un dollar singapourien.

Vitesse de paiement et montant minimum #

Le tableau ci-dessus est un cas standard. La vitesse de paiement peut varier en fonction des banques et peut prendre quelques jours de plus. Le type d'entreprise et le pays dans lequel vous vous trouvez peuvent également avoir une incidence sur le délai de paiement.

Commencez votre paiement #

Vous pouvez créer un paiement avec l'API Wooshpay. En général, il y a deux scénarios pour les paiements：

1. Paiements globaux
2. Paiements à la Chine

Avant de créer un paiement, certains paramètres doivent être spécifiés :

• bénéficiaire : Les coordonnées du bénéficiaire doivent être fournies dans cet objet, s'il s'agit d'un premier paiement, qui doit être effectué par l'intermédiaire d'une banque. identifiant_du_bénéficiaire n'est pas utilisé. ) .
• type : Le type doit être soit entreprise (pour l'entreprise) ou bénéficiaire (pour les particuliers)
• entreprise : Détails de l'entreprise requis, y compris nom_de_l'entreprise, adresse et info_supplémentaire.
• bénéficiaire : Détails de l'entreprise requis, y compris adresse, info_supplémentaire.
• destination : A demandé les informations relatives au compte bancaire ou à la carte à laquelle le paiement a été envoyé.

Paiements globaux #

Créer un paiement global

Pour créer un nouveau paiement global en fournissant directement les informations sur le bénéficiaire

A la demande de l'entreprise

{
  "beneficiary_data" : {
    "type" : "entreprise",
    "entreprise" : {
      "company_registered_name" : "XXX ltd",
      "adresse" : {
        "line1" : "Bloc 3A",
        "ligne2" : "Parc XX",
        "code_postal" : "98109",
        "city" : "Seattle",
        "state" : "WA",
        "country" : "USA"
      },
      "additional_info" : {
        "business_registration_number" : "32342353535334234MCA4",
        "legal_rep_first_name" : "Ming",
        "legal_rep_last_name" : "Zhang",
        "legal_rep_id_type" : "NATIONAL_ID",
        "legal_rep_id_number" : "233923874838920238X",
        "legal_rep_email" : "[email protected]",
        "legal_rep_phone" : "13727282938"
      }
    }
  },
  "montant" : 666,
  "devise" : "cny",
  "description" : "Vous pouvez ajouter une description ici",
  "type" : "bank_account",
  "destination_data" : {
    "source" : {
      "account_holder_name" : "xxxx ltd",
      "account_holder_type" : "société",
      "bank_name" : "Bank of America",
      "country" : "USA",
      "currency" : "USD",
      "account_number" : "6210000000000002"
    }
  }
}

Réponse

  {
      "id" : "po_1654453881670729728",
      "object" : "payout",
      "created" : 1683287519000,
      "currency" : "CNY",
      "montant" : 666,
      "description" : "Vous pouvez ajouter une description ici",
      "statut" : "en attente",
      "destination" : {
          "id" : "ba_1654453883419754496",
          "objet" : "bank_account",
          "créé" : 1683287519000,
          "country" : "USA",
          "devise" : "USD",
          "fingerprint" : "817902e3b6a2cf61eebc484f89467be650063413",
          "last4" : "0002",
          "account_holder_name" : "xxxx ltd",
          "account_holder_type" : "company"
      },
      "livemode" : faux,
      "type" : "bank_account",
      "méthode" : "standard",
      "bénéficiaire" : {
          "id" : "bf_1654453881691701248",
          "objet" : "bénéficiaire",
          "type" : "entreprise",
          "entreprise" : {
              "adresse" : {
                  "city" : "Seattle",
                  "country" : "USA",
                  "line1" : "Bloc 3A",
                  "line2" : "XX Park",
                  "state" : "WA",
                  "code_postal" : "98109"
              },
              "company_registered_name" : "XXX ltd",
              "additional_info" : {
                  "business_registration_number" : "32342353535334234MCA4",
                  "legal_rep_first_name" : "Ming",
                  "legal_rep_last_name" : "Zhang",
                  "legal_rep_id_type" : "NATIONAL_ID",
                  "legal_rep_id_number" : "233923874838920238X",
                  "legal_rep_email" : "[email protected]",
                  "legal_rep_phone" : "13727282938"
              }
          }
      }
  }

Pour une demande individuelle
Pour créer un paiement en fournissant directement les informations sur le bénéficiaire

  {
    "beneficiary_data" : {
      "type" : "bénéficiaire",
      "bénéficiaire":{
          "address" : {
          "line1" : "### Ave",
          "line2" : "#501",
          "code_postal" : "98109",
          "city" : "Seattle",
          "state" : "WA",
          "country" : "USA"
        },
      "additional_info" : {
          "last_name" : "Kale",
          "prénom" : "Leo",
          "id_type" : "NATIONAL_ID",
          "id_country_iso_code" : "USA",
          "id_number":"234242423423434X",
          "email" : "[email protected]",
          "phone" : "1234534343"
        }
      }
    },
    "montant" : 1000,
    "devise" : "USD",
    "description" : "Vous pouvez ajouter une description ici",
    "type" : "bank_account",
    "destination_data" : {
      "source" : {
        "account_holder_name" : "Leo Kale",
        "account_holder_type" : "individu",
        "bank_name" : "Bank of America",
        "country" : "USA",
        "devise" : "USD",
        "account_number" : "6210000000000002"
      }
    }
  }

Réponse

  {
      "id" : "po_1654455721024028672",
      "object" : "payout",
      "created" : 1683287958000,
      "currency" : "USD",
      "montant" : 1000,
      "description" : "Vous pouvez ajouter une description ici",
      "statut" : "en attente",
      "destination" : {
          "id" : "ba_1654455722777247744",
          "objet" : "bank_account",
          "créé" : 1683287957000,
          "country" : "USA",
          "devise" : "USD",
          "empreinte digitale" : "3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
          "last4" : "0002",
          "account_holder_name" : "Leo Kale",
          "account_holder_type" : "individu"
      },
      "livemode" : faux,
      "type" : "bank_account",
      "méthode" : "standard",
      "bénéficiaire" : {
          "id" : "bf_1654455721040805888",
          "objet" : "bénéficiaire",
          "type" : "bénéficiaire",
          "bénéficiaire" : {
              "address" : {
                  "city" : "Seattle",
                  "country" : "USA",
                  "line1" : "### Ave",
                  "line2" : "#501",
                  "state" : "WA",
                  "code_postal" : "98109"
              },
              "additional_info" : {
                  "email" : "[email protected]",
                  "phone" : "1234534343",
                  "nom" : "LeoKale",
                  "last_name" : "Kale",
                  "prénom" : "Leo",
                  "id_type" : "NATIONAL_ID",
                  "id_country_iso_code" : "USA",
                  "id_number" : "234242423423434X"
              }
          }
      }
  }

Paiements récurrents

Si le bénéficiaire n'a jamais reçu de paiement, vous pouvez créer un paiement à l'aide de la fonction identifiant_du_bénéficiaire, destination_id qui est sauvegardé sur le serveur et que vous pouvez trouver dans la dernière réponse.

Dans le cas ci-dessus, identifiant_du_bénéficiaire est "bf_1579357548861980672" et destination_id est "ba_1654455722777247744"

Demande

{
  "bénéficiaire" : "bf_1579357548861980672",
  "montant" : 888,
  "devise" : "USD",
  "description" : "Vous pouvez ajouter une description ici",
  "type" : "bank_account",
  "destination" : "ba_1654455722777247744"
}

Paiements à la Chine #

Créer un nouveau paiement vers la Chine

La différence avec les paiements globaux réside dans le fait que vous devez soumettre le payment_intents_id lors de la demande de paiement à la Chine.

Demande

  {
    "bénéficiaire" : "bf_1579357548861980672",
    "montant" : 666,
    "devise" : "cny",
    "description" : "Vous pouvez ajouter une description ici",
    "type" : "bank_account",
    "destination_data" : {
      "source" : {
        "account_holder_name" : "xxxx ltd",
        "account_holder_type" : "société",
        "bank_name" : "Bank of China",
        "country" : "CN",
        "currency" : "CNY",
        "account_number" : "6210000000000002"
      }
    },
    "payment_intents_id" : [
      "pi_1577840204872417280"
    ]
  }

Créer un paiement avec des documents de conformité

Si vous devez nous soumettre des documents de conformité, la création d'un paiement avec des documents de conformité se fait en trois étapes

1. Télécharger les documents de conformité à l'aide de la fonction Créer un fichier

Demande

  curl --location --request POST 'https://apitest.wooshpay.com/v1/files' \N-header 'Accept : application/json'.
  --header 'Accept : application/json' \N ---en-tête 'Accept : application/json' \N ---en-tête 'Authorization:' \N
  --header 'Autorisation : Votre clé" \N
  --header 'User-Agent : Apifox/1.0.0' \N-formulaire
  --form 'file=@"/路径/xxx.pdf"'

Réponse

  {
      "id" : "file_1654416327596572672",
      "objet" : "fichier",
      "créé" : 1683278565516,
      "url" : "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf",
      "type" : "pdf",
      "filename" : "1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
  }

2. Copier le URL sur votre réponse Dans le cas ci-dessus, le URL est https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf
3. Appliquer métadonnées au paiement créé

• métadonnées : Il se compose de deux parties, la première étant la clé et la seconde partie est le valeur.
• eg : "métadonnées" : { "compliance document" : "L'url de votre document", "key2" : "value2", "..." : "..." }

Demande

  {
      {
    "beneficiary" : "bf_1579357548861980672",
    "métadonnées" : {
          "document de conformité" : "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },

    "montant" : 666,
    "devise" : "cny",
    "description" : "Vous pouvez ajouter une description ici",
    "type" : "bank_account",
    "destination_data" : {
      "source" : {
        "account_holder_name" : "xxxx ltd",
        "account_holder_type" : "société",
        "bank_name" : "Bank of China",
        "country" : "CN",
        "currency" : "CNY",
        "account_number" : "6210000000000002"
      }
    },
    "payment_intents_id" : [
      "pi_1577840204872417280"
    ]
  }
  }

Répondu

  {
      "id" : "po_1654421512435793920",
      "object" : "payout",
      "created" : 1683279802000,
      "currency" : "CNY",
      "montant" : 666,
      "description" : "Vous pouvez ajouter une description ici",
      "métadonnées" : {
          "document de conformité" : "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },
      "status" : "en attente",
      "destination" : {
          "id" : "ba_1654421514230956032",
          "objet" : "bank_account",
          "créé" : 1683279801000,
          "country" : "CN",
          "currency" : "CNY",
          "fingerprint" : "4732b34681776e6b2383da452cbbabbcd2228d48",
          "last4" : "0002",
          "account_holder_name" : "xxxx ltd",
          "account_holder_type" : "company"
      },
      "livemode" : faux,
      "type" : "bank_account",
      "méthode" : "standard",
      "bénéficiaire" : {
          "id" : "bf_1654421512456765440",
          "objet" : "bénéficiaire",
          "type" : "entreprise",
          "business" : {
              "adresse" : {
                  "city" : "Pékin",
                  "country" : "CN",
                  "line1" : "Bloc 3A",
                  "ligne2" : "XX Park",
                  "state" : "Beijing",
                  "postal_code" : "323111"
              },
              "company_registered_name" : "XXX ltd",
              "additional_info" : {
                  "business_registration_number" : "32342353535334234MCA4",
                  "legal_rep_first_name" : "Ming",
                  "legal_rep_last_name" : "Zhang",
                  "legal_rep_id_type" : "NATIONAL_ID",
                  "legal_rep_id_number" : "233923874838920238X",
                  "legal_rep_email" : "[email protected]",
                  "legal_rep_phone" : "13727282938"
              }
          }
      },
      "payment_intents_id" : [
          "pi_1577840204872417280"
      ]
  }

Défauts de paiement #

Si le compte bancaire ne peut pas recevoir un paiement pour une raison quelconque, la banque nous renvoie les fonds. Nous recevons alors un message d'erreur indiquant la raison de l'échec. Il peut s'écouler plusieurs jours ouvrables avant que votre banque ne renvoie le paiement et ne nous informe de l'échec. Si cela se produit, vous en êtes informé dans le tableau de bord. Assurez-vous que les informations relatives au compte bancaire que vous fournissez sont correctes. Si ce n'est pas le cas (une faute de frappe dans le numéro de compte, par exemple), il se peut que les paiements soient envoyés à un autre titulaire de compte bancaire.

Paiements négatifs #

Chaque paiement reflète le solde disponible de votre compte au moment où il a été créé. Dans certains cas, le solde de votre compte peut être négatif. Par exemple, si vous recevez 100 USD de paiements mais que vous remboursez 200 USD de paiements antérieurs, le solde de votre compte sera de -100 USD. Si vous ne recevez pas d'autres paiements pour compenser le montant négatif, un nouveau paiement échouera.

En savoir plus sur les résultats de votre paiement #

Pour savoir si un paiement sur un compte bancaire a été effectué avec succès, vous devez mettre en place un webhook.

Les types d'événements suivants sont importants lorsque vous effectuez des paiements sur des comptes bancaires, et vous pouvez créer un webhook pour connaître le statut de votre paiement.

• paiement.annulé: Se produit lorsqu'un paiement est annulé.
• payout.created: Se produit chaque fois qu'un paiement est créé.
• payout.failed: Se produit chaque fois qu'une tentative de paiement échoue.
• payout.paid: Se produit chaque fois qu'un paiement est censé être disponible sur le compte de destination. Si le paiement échoue, une notification payout.failed est également envoyée ultérieurement.
• payout.updated: Se produit chaque fois qu'un paiement est mis à jour.

Après avoir identifié les événements à surveiller, vous pouvez vous référer au guide des webhooks pour Créer un webhook.

Paiements instantanés #

Avec les paiements instantanés, l'envoi de fonds sur un compte bancaire pris en charge (au Royaume-Uni) peut être traité dans la journée. Vous pouvez demander des paiements instantanés n'importe quand, y compris les week-ends et les jours fériés, et les fonds apparaissent généralement sur le compte bancaire associé.