Wooshpay è in grado di effettuare pagamenti sul tuo conto bancario. È possibile visualizzare un elenco di tutti i pagamenti effettuati sul conto bancario nella Dashboard. Inoltre, è possibile recuperare l'elenco dei pagamenti tramite API.

Stato dei pagamenti #

Esistono cinque stati di una richiesta di pagamento. Una volta creato il pagamento, lo stato iniziale sarà in attesa. Quando viene richiamata l'API cancel, lo stato verrà annullato, portando alla cancellazione del processo di pagamento. Quando la richiesta viene inoltrata alla banca, lo stato diventa in_transit. Poi si scompone in due possibilità: se l'elaborazione bancaria fallisce, il risultato del pagamento sarà Failed (fallito); se l'elaborazione bancaria ha successo, lo stato sarà paid (pagato).

Velocità di pagamento #

Mentre il programma di pagamento si riferisce alla cadenza con cui vengono versati i fondi (ad esempio, il giorno della settimana), la velocità di pagamento si riferisce alla quantità di tempo necessaria per rendere disponibili i fondi. La velocità di pagamento varia a seconda del Paese ed è generalmente espressa come T+X giorni. Alcuni processori di pagamento possono far iniziare "T" dal loro tempo di regolamento interno, ovvero quando i fondi arrivano sui loro conti bancari.

"T" si riferisce al tempo di transazione, ossia al momento della conferma o dell'acquisizione del pagamento iniziale. Ad esempio, se il vostro conto ha sede in un paese con una velocità di pagamento standard T+3 e avete un programma di pagamento manuale, il vostro saldo sarà disponibile per il pagamento entro 3 giorni lavorativi dal momento in cui avete acquisito un pagamento.

Importo minimo di pagamento #

L'importo minimo del versamento è tipicamente un'unità base della valuta locale. Ad esempio, negli Stati Uniti il versamento minimo è di un dollaro USA, mentre a Singapore il versamento minimo è di un dollaro Singapore.

Velocità di pagamento e importo minimo #

La tabella sopra riportata è un caso standard. La velocità di pagamento può variare a seconda delle banche e può richiedere qualche giorno in più. Anche il tipo di attività e il Paese in cui ci si trova possono influire sui tempi di pagamento.

Iniziare il pagamento #

È possibile creare un pagamento con l'API di Wooshpay. In generale, ci sono due scenari per i pagamenti: - il pagamento

1. Pagamenti globali
2. Pagamenti alla Cina

Prima di creare un pagamento, è necessario specificare alcuni parametri:

• beneficiario : I dati del beneficiario devono essere forniti in questo oggetto, se si tratta di un pagamento iniziale che beneficiario_id non viene utilizzato. ) .
• tipo : Il tipo deve essere attività commerciale (per l'azienda) o beneficiario (per i singoli)
• attività commerciale : Richiesti i dettagli dell'azienda, tra cui nome_azienda_registrata, indirizzo e informazioni_aggiuntive.
• beneficiario : Richiesti i dettagli dell'azienda, tra cui indirizzo, informazioni_aggiuntive.
• destinazione : Richiesti i dati del conto bancario o della carta a cui è stato inviato il pagamento.

Pagamenti globali #

Creare un pagamento globale

Per creare un nuovo pagamento globale fornendo direttamente le informazioni del beneficiario

Per richiesta dell'azienda

{
  "dati_beneficiario": {
    "tipo": "business",
    "attività": {
      "nome_azienda_registrata": "XXX ltd",
      "indirizzo": {
        "linea1": "Blocco 3A",
        "linea2": "XX Park",
        "codice postale": "98109",
        "città": "Seattle",
        "stato": "WA",
        "paese": "USA"
      },
      "additional_info": {
        "numero_di_registrazione_aziendale": "32342353535334234MCA4",
        "nome_legale_rep": "Ming",
        "legal_rep_last_name": "Zhang",
        "legal_rep_type": "ID NAZIONALE",
        "legal_rep_id_number": "233923874838920238X",
        "legal_rep_email": "xxx@email.com",
        "telefono_legale": "13727282938"
      }
    }
  },
  "importo": 666,
  "valuta": "cny",
  "descrizione": "È possibile aggiungere la descrizione qui",
  "tipo": "conto_bancario",
  "dati_destinazione": {
    "fonte": {
      "nome_titolare_conto": "xxxx ltd",
      "tipo_di_conto": "società",
      "nome_banca": "Bank of America",
      "paese": "USA",
      "valuta": "USD",
      "numero_di_conto": "6210000000000002"
    }
  }
}

Risposta

  {
      "id": "po_1654453881670729728",
      "oggetto": "payout",
      "creato": 1683287519000,
      "valuta": "CNY",
      "importo": 666,
      "descrizione": "È possibile aggiungere la descrizione qui",
      "stato": "in attesa",
      "destinazione": {
          "id": "ba_1654453883419754496",
          "oggetto": "conto_bancario",
          "creato": 1683287519000,
          "paese": "USA",
          "valuta": "USD",
          "impronta digitale": "817902e3b6a2cf61eebc484f89467be650063413",
          "last4": "0002",
          "nome_titolare_conto": "xxxx ltd",
          "tipo_di_conto": "società"
      },
      "livemode": false,
      "tipo": "conto_banca",
      "metodo": "standard",
      "beneficiario": {
          "id": "bf_1654453881691701248",
          "oggetto": "beneficiario",
          "tipo": "business",
          "attività": {
              "indirizzo": {
                  "città": "Seattle",
                  "paese": "USA",
                  "linea1": "Blocco 3A",
                  "linea2": "XX Park",
                  "stato": "WA",
                  "codice postale": "98109"
              },
              "nome_azienda_registrata": "XXX ltd",
              "additional_info": {
                  "numero_registrazione_aziendale": "32342353535334234MCA4",
                  "legal_rep_first_name": "Ming",
                  "legal_rep_last_name": "Zhang",
                  "legal_rep_type": "ID NAZIONALE",
                  "legal_rep_id_number": "233923874838920238X",
                  "legal_rep_email": "xxx@email.com",
                  "telefono_legale": "13727282938"
              }
          }
      }
  }

Per una richiesta individuale
Per creare un pagamento fornendo direttamente le informazioni del beneficiario

  {
    "dati_beneficiario": {
      "tipo": "beneficiario",
      "beneficiario":{
          "indirizzo": {
          "linea1": "### Ave",
          "riga2": "#501",
          "codice postale": "98109",
          "città": "Seattle",
          "stato": "WA",
          "paese": "USA"
        },
      "additional_info": {
          "cognome": "Kale",
          "nome_nome": "Leo",
          "id_type": "NATIONAL_ID",
          "id_country_iso_code": "USA",
          "id_number":"234242423423434X",
          "email": "xxx@email.com",
          "telefono": "1234534343"
        }
      }
    },
    "importo": 1000,
    "valuta": "USD",
    "descrizione": "È possibile aggiungere una descrizione qui",
    "tipo": "conto_bancario",
    "dati_destinazione": {
      "fonte": {
        "nome_titolare_conto": "Leo Kale",
        "tipo_di_conto": "individual",
        "nome_banca": "Bank of America",
        "paese": "USA",
        "valuta": "USD",
        "numero_di_conto": "6210000000000002"
      }
    }
  }

Risposta

  {
      "id": "po_1654455721024028672",
      "oggetto": "payout",
      "creato": 1683287958000,
      "valuta": "USD",
      "importo": 1000,
      "descrizione": "È possibile aggiungere una descrizione qui",
      "stato": "in attesa",
      "destinazione": {
          "id": "ba_1654455722777247744",
          "oggetto": "conto_bancario",
          "creato": 1683287957000,
          "paese": "USA",
          "valuta": "USD",
          "impronta digitale": "3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
          "last4": "0002",
          "nome_titolare_conto": "Leo Kale",
          "tipo_di_conto": "individual"
      },
      "livemode": false,
      "tipo": "conto_bancario",
      "metodo": "standard",
      "beneficiario": {
          "id": "bf_1654455721040805888",
          "oggetto": "beneficiario",
          "tipo": "beneficiario",
          "beneficiario": {
              "indirizzo": {
                  "città": "Seattle",
                  "paese": "USA",
                  "linea1": "### Ave",
                  "linea2": "#501",
                  "stato": "WA",
                  "codice postale": "98109"
              },
              "additional_info": {
                  "email": "xxx@email.com",
                  "telefono": "1234534343",
                  "nome": "LeoKale",
                  "cognome": "Kale",
                  "nome_nome": "Leo",
                  "id_tipo": "ID_NAZIONALE",
                  "id_country_iso_code": "USA",
                  "id_numero": "234242423423434X"
              }
          }
      }
  }

Pagamenti ricorrenti

Se si dispone già di un pagamento al beneficiario, è possibile creare un pagamento utilizzando beneficiario_id, destinazione_id che viene salvato sul server e si trova nell'ultima risposta.

Nel caso precedente, beneficiario_id è "bf_1579357548861980672" e destinazione_id è "ba_1654455722777247744"

Richiesta

{
  "beneficiario": "bf_1579357548861980672",
  "importo": 888,
  "valuta": "USD",
  "descrizione": "È possibile aggiungere una descrizione qui",
  "tipo": "conto_bancario",
  "destinazione": "ba_1654455722777247744"
}

Pagamenti alla Cina #

Creare un nuovo pagamento verso la Cina

La differenza con i pagamenti globali consiste nel fatto che è necessario inviare i dati di ID_intenti_di_pagamento quando si richiede un pagamento in Cina.

Richiesta

  {
    "beneficiario": "bf_1579357548861980672",
    "importo": 666,
    "valuta": "cny",
    "descrizione": "È possibile aggiungere la descrizione qui",
    "tipo": "conto_bancario",
    "dati_destinazione": {
      "fonte": {
        "nome_titolare_conto": "xxxx ltd",
        "tipo_di_conto": "società",
        "nome_banca": "Bank of China",
        "paese": "CN",
        "valuta": "CNY",
        "numero_di_conto": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }

Creare un pagamento con documenti di conformità

Se avete bisogno di inviarci i documenti di conformità, ci sono tre fasi per creare un pagamento con documenti di conformità

1. Caricare i documenti di conformità utilizzando Crea un file

Richiesta

  curl --location --request POST 'https://apitest.wooshpay.com/v1/files' \
  --header 'Accept: application/json' \
  --header 'Autorizzazione: La tua chiave' \
  --header 'User-Agent: Apifox/1.0.0' ´
  --form 'file=@"/路径/xxx.pdf"'

Risposta

  {
      "id": "file_1654416327596572672",
      "oggetto": "file",
      "creato": 1683278565516,
      "url": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf",
      "tipo": "pdf",
      "nome file": "1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
  }

2. Copiare il URL su la vostra risposta Nel caso precedente, il URL è https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf
3. Applicare metadati al pagamento creato

• metadati : Si compone di due parti, la prima delle quali è il chiave e la seconda parte è il valore.
• es: "metadati": {"compliance document": "L'url del vostro documento", "key2": "valore2", "...": "..." }

Richiesta

  {
      {
    "beneficiario": "bf_1579357548861980672",
    "metadati": {
          "documento di conformità": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },

    "importo": 666,
    "valuta": "cny",
    "descrizione": "È possibile aggiungere la descrizione qui",
    "tipo": "conto_bancario",
    "dati_destinazione": {
      "fonte": {
        "nome_titolare_conto": "xxxx ltd",
        "tipo_di_conto": "società",
        "nome_banca": "Bank of China",
        "paese": "CN",
        "valuta": "CNY",
        "numero_di_conto": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }
  }

Risponde

  {
      "id": "po_1654421512435793920",
      "oggetto": "payout",
      "creato": 1683279802000,
      "valuta": "CNY",
      "importo": 666,
      "descrizione": "È possibile aggiungere la descrizione qui",
      "metadati": {
          "documento di conformità": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },
      "stato": "in attesa",
      "destinazione": {
          "id": "ba_1654421514230956032",
          "oggetto": "conto_bancario",
          "creato": 1683279801000,
          "paese": "CN",
          "valuta": "CNY",
          "impronta digitale": "4732b34681776e6b2383da452cbbabbcd2228d48",
          "last4": "0002",
          "nome_titolare_del_conto": "xxxx ltd",
          "tipo_di_conto": "società"
      },
      "livemode": false,
      "tipo": "conto_banca",
      "metodo": "standard",
      "beneficiario": {
          "id": "bf_1654421512456765440",
          "oggetto": "beneficiario",
          "tipo": "business",
          "attività": {
              "indirizzo": {
                  "città": "Pechino",
                  "paese": "CN",
                  "linea1": "Blocco 3A",
                  "linea2": "XX Park",
                  "stato": "Beijing",
                  "codice postale": "323111"
              },
              "nome_azienda_registrata": "XXX ltd",
              "additional_info": {
                  "numero_registrazione_aziendale": "32342353535334234MCA4",
                  "legal_rep_first_name": "Ming",
                  "legal_rep_last_name": "Zhang",
                  "legal_rep_type": "ID NAZIONALE",
                  "legal_rep_id_number": "233923874838920238X",
                  "legal_rep_email": "xxx@email.com",
                  "telefono_legale": "13727282938"
              }
          }
      },
      "payment_intents_id": [
          "pi_1577840204872417280"
      ]
  }

Fallimenti nei pagamenti #

Se il conto bancario non può ricevere un pagamento per qualsiasi motivo, la banca ci rimanda i fondi. Questo restituisce un errore con il motivo del fallimento. La banca può impiegare diversi giorni lavorativi per restituire il pagamento e informarci del fallimento. In tal caso, l'utente viene avvisato nella Dashboard. Assicurarsi che le informazioni sul conto bancario fornite siano corrette. In caso contrario (ad esempio, un errore di battitura nel numero di conto), i pagamenti potrebbero essere inviati a un altro titolare di conto bancario.

Pagamenti negativi #

Ogni versamento riflette il saldo disponibile del conto al momento della sua creazione. In alcuni casi, il saldo del conto può essere negativo. Ad esempio, se si ricevono 100 USD di pagamenti ma si rimborsano 200 USD di pagamenti precedenti, il saldo del conto sarà di -100 USD. Se non si ricevono altri pagamenti per bilanciare l'importo negativo, un nuovo pagamento non andrà a buon fine.

Scopri i risultati del tuo rimborso #

Per sapere se un pagamento su un conto bancario è andato a buon fine, è necessario impostare un webhook.

I seguenti tipi di evento sono importanti quando si effettuano pagamenti a conti bancari e si possono creare webhook per conoscere lo stato del pagamento.

• pagamento.annullato: Si verifica ogni volta che un pagamento viene annullato.
• payout.creato: Si verifica ogni volta che viene creato un pagamento.
• payout.failed: Si verifica ogni volta che un tentativo di pagamento fallisce.
• pagamento.pagato: Si verifica ogni volta che si prevede che un pagamento sia disponibile sul conto di destinazione. Se il pagamento non riesce, viene inviata anche una notifica payout.failed, in un momento successivo.
• payout.aggiornato: Si verifica ogni volta che viene aggiornato un pagamento.

Dopo aver identificato gli eventi da monitorare, si può fare riferimento alla guida webhook per Creare un webhook.

Pagamenti istantanei #

Con i pagamenti istantanei, l'invio di fondi a un conto bancario supportato (nel Regno Unito) può essere elaborato entro un giorno. È possibile richiedere i pagamenti istantanei in qualsiasi giorno o ora, compresi i fine settimana e i giorni festivi, e i fondi appaiono solitamente sul conto bancario associato.