O Wooshpay pode fazer pagamentos em sua conta bancária. Você pode visualizar uma lista de todos os seus pagamentos em sua conta bancária no Painel. Além disso, você pode recuperar a lista de pagamentos pela API.

Status do pagamento #

Há cinco estados de uma solicitação de pagamento. Depois que o pagamento for criado, o estado inicial será pendente. Quando a API de cancelamento for chamada, o estado será cancelado, levando ao cancelamento do processo de pagamento. Quando a solicitação é enviada ao banco, o estado passa a ser in_transit. Em seguida, ele se divide em duas possibilidades: se o processamento bancário falhar, o resultado do pagamento será Failed; se o processamento bancário for bem-sucedido, o status será paid.

Velocidade de pagamento #

Enquanto o cronograma de pagamento se refere à cadência em que seus fundos são pagos (por exemplo, dia da semana), a velocidade de pagamento se refere ao tempo necessário para que seus fundos fiquem disponíveis. A velocidade de pagamento varia de acordo com o país e é normalmente expressa como T+X dias. Alguns processadores de pagamento podem iniciar o "T" a partir de seu tempo de liquidação interno, ou seja, quando os fundos chegam às suas contas bancárias.

"T" refere-se ao tempo de transação, ou seja, o tempo de confirmação ou captura do pagamento inicial. Por exemplo, se sua conta estiver localizada em um país com uma velocidade de pagamento padrão T+3 e você estiver em uma programação de pagamento manual, seu saldo estará disponível para pagamento em 3 dias úteis a partir do momento em que você capturou um pagamento.

Valor mínimo de pagamento #

O valor mínimo de pagamento é normalmente uma unidade básica da moeda local. Por exemplo, nos EUA, o pagamento mínimo é de um dólar americano, enquanto em Cingapura o pagamento mínimo é de um dólar de Cingapura.

Velocidade de pagamento e valor mínimo #

A tabela acima é um caso padrão. A velocidade de pagamento pode variar devido a diferentes bancos, e pode levar alguns dias a mais. O tipo de negócio e o país em que você se encontra também podem afetar o tempo de pagamento.

Inicie seu pagamento #

Você pode criar um pagamento com a API do Wooshpay. Em geral, há dois cenários para pagamentos:：

1. Pagamentos globais
2. Pagamentos para a China

Antes de criar um pagamento, há alguns parâmetros necessários que devem ser especificados:

• beneficiário : Os detalhes do beneficiário devem ser fornecidos nesse objeto, se esse for um pagamento inicial que beneficiary_id não é usado. ) .
• tipo : O tipo deve ser negócios (para empresa) ou beneficiário (para pessoa física)
• negócios : Detalhes obrigatórios da empresa, incluindo nome_registrado_da_empresa, endereço e informação_adicional.
• beneficiário : Detalhes obrigatórios da empresa, incluindo endereço, informação_adicional.
• destino : Requer a conta bancária ou as informações do cartão para o qual o pagamento foi enviado.

Pagamentos globais #

Criar um pagamento global

Para criar um novo Pagamento Global, fornecendo diretamente as informações do beneficiário

Para solicitação da empresa

{
  "beneficiary_data": {
    "type": "business",
    "business": {
      "company_registered_name": "XXX ltd",
      "address" (endereço): {
        "line1": "Block 3A",
        "line2": "XX Park",
        "postal_code": "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": "xxx@email.com",
        "legal_rep_phone": "13727282938"
      }
    }
  },
  "amount" (valor): 666,
  "currency": "cny",
  "description": "Você pode adicionar a descrição aqui",
  "type": "bank_account",
  "destination_data": {
    "source": {
      "account_holder_name": "xxxx ltd",
      "account_holder_type": "company",
      "bank_name": "Bank of America",
      "country" (país): "USA",
      "currency": "USD",
      "account_number": "6210000000000002"
    }
  }
}

Resposta

  {
      "id": "po_1654453881670729728",
      "object": "payout",
      "created": 1683287519000,
      "currency": "CNY",
      "amount" (valor): 666,
      "description": "Você pode adicionar a descrição aqui",
      "status": "pending" (pendente),
      "destination" (destino): {
          "id": "ba_1654453883419754496",
          "object": "bank_account",
          "created": 1683287519000,
          "country": "USA",
          "currency": "USD",
          "fingerprint" (impressão digital): "817902e3b6a2cf61eebc484f89467be650063413",
          "last4": "0002",
          "account_holder_name": "xxxx ltd",
          "account_holder_type": "company"
      },
      "livemode": falso,
      "type": "bank_account",
      "method" (método): "standard",
      "beneficiary" (beneficiário): {
          "id": "bf_1654453881691701248",
          "object": "beneficiary" (beneficiário),
          "type": "business",
          "business": {
              "address" (endereço): {
                  "city" (cidade): "Seattle",
                  "country" (país): "USA",
                  "line1": "Block 3A",
                  "line2": "XX Park",
                  "state" (estado): "WA",
                  "postal_code": "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": "xxx@email.com",
                  "legal_rep_phone": "13727282938"
              }
          }
      }
  }

Para solicitação individual
Para criar um pagamento fornecendo diretamente as informações do beneficiário

  {
    "beneficiary_data": {
      "type": "payee" (beneficiário),
      "payee":{
          "address" (endereço): {
          "line1": "### Ave",
          "line2": "#501",
          "postal_code": "98109",
          "city" (cidade): "Seattle",
          "state": "WA",
          "country": "USA"
        },
      "additional_info": {
          "last_name": "Kale",
          "first_name": "Leo",
          "id_type": "NATIONAL_ID",
          "id_country_iso_code": "USA",
          "id_number":"234242423423434X",
          "email": "xxx@email.com",
          "phone": "1234534343"
        }
      }
    },
    "amount" (valor): 1000,
    "currency": "USD",
    "description": "Você pode adicionar a descrição aqui",
    "type": "bank_account",
    "destination_data": {
      "source": {
        "account_holder_name": "Leo Kale",
        "account_holder_type": "individual",
        "bank_name": "Bank of America",
        "country" (país): "USA",
        "currency": "USD",
        "account_number": "6210000000000002"
      }
    }
  }

Resposta

  {
      "id": "po_1654455721024028672",
      "object": "payout",
      "created": 1683287958000,
      "currency": "USD",
      "amount": 1000,
      "description": "Você pode adicionar a descrição aqui",
      "status": "pending" (pendente),
      "destination" (destino): {
          "id": "ba_1654455722777247744",
          "object": "bank_account",
          "created": 1683287957000,
          "country": "USA",
          "currency": "USD",
          "fingerprint" (impressão digital): "3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
          "last4": "0002",
          "account_holder_name": "Leo Kale",
          "account_holder_type": "individual"
      },
      "livemode": falso,
      "type" (tipo): "bank_account",
      "method" (método): "standard",
      "beneficiary" (beneficiário): {
          "id": "bf_1654455721040805888",
          "object": "beneficiary" (beneficiário),
          "type": "payee",
          "payee": {
              "address": {
                  "city" (cidade): "Seattle",
                  "country" (país): "USA",
                  "line1": "### Ave",
                  "line2": "#501",
                  "state" (estado): "WA",
                  "postal_code": "98109"
              },
              "additional_info": {
                  "email": "xxx@email.com",
                  "phone" (telefone): "1234534343",
                  "name" (nome): "LeoKale",
                  "last_name": "Kale",
                  "first_name": "Leo",
                  "id_type": "NATIONAL_ID",
                  "id_country_iso_code": "USA",
                  "id_number": "234242423423434X"
              }
          }
      }
  }

Pagamentos recorrentes

Se você já tiver algum pagamento para o beneficiário, poderá criar um pagamento usando beneficiary_id, ID do destino que é salvo no servidor e você pode encontrá-lo na última resposta.

No caso acima, beneficiary_id é "bf_1579357548861980672" e ID do destino é "ba_1654455722777247744"

Solicitação

{
  "beneficiary": "bf_1579357548861980672",
  "amount" (valor): 888,
  "currency" (moeda): "USD",
  "description": "Você pode adicionar a descrição aqui",
  "type": "bank_account",
  "destination" (destino): "ba_1654455722777247744"
}

Pagamentos para a China #

Criar um novo pagamento para a China

A diferença com os pagamentos globais é que você precisa enviar o payment_intents_id ao solicitar um pagamento para a China.

Solicitação

  {
    "beneficiary": "bf_1579357548861980672",
    "amount" (valor): 666,
    "currency" (moeda): "cny",
    "description": "Você pode adicionar a descrição aqui",
    "type": "bank_account",
    "destination_data": {
      "source": {
        "account_holder_name": "xxxx ltd",
        "account_holder_type": "company",
        "bank_name": "Bank of China",
        "country" (país): "CN",
        "currency" (moeda): "CNY",
        "account_number": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }

Criar um pagamento com documentos de conformidade

Se você precisar enviar documentos de conformidade para nós, há três etapas para criar um pagamento com documentos de conformidade

1. Faça o upload dos documentos de conformidade usando Criar um arquivo

Solicitação

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

Resposta

  {
      "id": "file_1654416327596572672",
      "object" (objeto): "file" (arquivo),
      "created" (criado): 1683278565516,
      "url": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf",
      "type" (tipo): "pdf",
      "filename" (nome do arquivo): "1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
  }

2. Copiar o URL em Sua resposta No caso acima, o URL é https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf
3. Aplicar metadados para o pagamento criado

• metadados : Consiste em duas partes, a primeira é a chave e a segunda parte é o valor.
• Por exemplo: "metadados": { "compliance document" (documento de conformidade): "A url do seu documento", "key2": "value2", "...": "..." }

Solicitação

  {
      {
    "beneficiary": "bf_1579357548861980672",
    "metadata": {
          "documento de conformidade": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },

    "amount" (valor): 666,
    "currency": "cny",
    "description" (descrição): "Você pode adicionar a descrição aqui",
    "type": "bank_account",
    "destination_data": {
      "source": {
        "account_holder_name": "xxxx ltd",
        "account_holder_type": "company",
        "bank_name": "Bank of China",
        "country" (país): "CN",
        "currency" (moeda): "CNY",
        "account_number": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }
  }

Respondido

  {
      "id": "po_1654421512435793920",
      "object": "payout",
      "created": 1683279802000,
      "currency": "CNY",
      "amount" (valor): 666,
      "description": "Você pode adicionar a descrição aqui",
      "metadata": {
          "documento de conformidade": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },
      "status": "pending" (pendente),
      "destination" (destino): {
          "id": "ba_1654421514230956032",
          "object": "bank_account",
          "created": 1683279801000,
          "country": "CN",
          "currency": "CNY",
          "fingerprint" (impressão digital): "4732b34681776e6b2383da452cbbabbcd2228d48",
          "last4": "0002",
          "account_holder_name": "xxxx ltd",
          "account_holder_type": "company"
      },
      "livemode": falso,
      "type": "bank_account",
      "method" (método): "standard",
      "beneficiary" (beneficiário): {
          "id": "bf_1654421512456765440",
          "object": "beneficiary" (beneficiário),
          "type": "business",
          "business": {
              "address" (endereço): {
                  "city" (cidade): "Beijing",
                  "country" (país): "CN",
                  "line1": "Block 3A",
                  "line2": "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": "xxx@email.com",
                  "legal_rep_phone": "13727282938"
              }
          }
      },
      "payment_intents_id": [
          "pi_1577840204872417280"
      ]
  }

Falhas no pagamento #

Se a conta bancária não puder receber um pagamento por qualquer motivo, o banco enviará os fundos de volta para nós. Isso retorna um erro com o motivo da falha. Pode levar vários dias úteis para que seu banco devolva o pagamento e nos informe que ele falhou. Se isso acontecer, você será notificado no Painel. Verifique se as informações da conta bancária que você forneceu estão corretas. Se não estiverem (um erro de digitação no número da conta, por exemplo), os pagamentos poderão ser enviados a outro titular de conta bancária.

Pagamentos negativos #

Cada pagamento reflete o saldo disponível em sua conta no momento em que foi criado. Em alguns casos, você pode ter um saldo negativo na conta. Por exemplo, se você receber 100 USD em pagamentos, mas reembolsar 200 USD de pagamentos anteriores, o saldo da sua conta será de -100 USD. Se você não receber mais pagamentos para equilibrar o valor negativo, um novo pagamento falhará.

Saiba mais sobre os resultados de seu pagamento #

Para saber se um pagamento para uma conta bancária foi bem-sucedido, você precisa configurar um webhook.

Os seguintes tipos de evento são importantes quando você faz pagamentos para contas bancárias e pode criar um webhook para saber o status do seu pagamento.

• payout.canceled: Ocorre sempre que um pagamento é cancelado.
• payout.created: Ocorre sempre que um pagamento é criado.
• payout.failed: Ocorre sempre que uma tentativa de pagamento falha.
• payout.paid: Ocorre sempre que se espera que um pagamento esteja disponível na conta de destino. Se o pagamento falhar, uma notificação payout.failed também será enviada, em um momento posterior.
• payout.updated: Ocorre sempre que um pagamento é atualizado.

Depois de identificar os eventos a serem monitorados, você pode consultar o guia do webhook para Criar um webhook.

Pagamentos instantâneos #

Com o Instant Payouts, o envio de fundos para uma conta bancária compatível (no Reino Unido) pode ser processado em um dia. Você pode solicitar Instant Payouts a qualquer dia ou hora, inclusive nos finais de semana e feriados, e os fundos normalmente aparecem na conta bancária associada.