Wooshpay es capaz de hacer pagos a su cuenta bancaria. Puede ver una lista de todos sus pagos en su cuenta bancaria en el panel de control. También, puede recuperar la lista de pagos por API.

Estado del pago #

Hay cinco estados de una solicitud de pago. Una vez creado el pago, el estado inicial será pendiente. Cuando se llama a la API de cancelación, el estado será cancelado, lo que conlleva la cancelación del proceso de pago. Cuando la solicitud se envía al banco, el estado pasa a in_transit. Entonces se descompone en dos posibilidades: si el procesamiento bancario falla, conducirá a Failed del resultado del pago; si el procesamiento bancario tiene éxito, entonces conducirá al estado paid.

Velocidad de pago #

Mientras que el calendario de pagos se refiere a la cadencia con la que se abonan sus fondos (por ejemplo, el día de la semana), la velocidad de pago se refiere al tiempo que tardan sus fondos en estar disponibles. La velocidad de pago varía según el país y suele expresarse como T+X días. Algunos procesadores de pagos pueden comenzar "T" a partir de su hora de liquidación interna, es decir, cuando los fondos aterrizan en sus cuentas bancarias.

"T" se refiere a la hora de la transacción, es decir, la hora de la confirmación o captura inicial del pago. Por ejemplo, si su cuenta está radicada en un país con una velocidad de pago estándar T+3 y está en un programa de pago manual, su saldo estará disponible para el pago en un plazo de 3 días laborables desde el momento en que capturó un pago.

Importe mínimo de pago #

El importe mínimo de pago suele ser una unidad básica de la moneda local. Por ejemplo, en Estados Unidos, el pago mínimo es de un dólar estadounidense, mientras que en Singapur es de un dólar de Singapur.

Velocidad de pago e importe mínimo #

La tabla anterior es un caso estándar. La velocidad de pago puede variar debido a los diferentes bancos, y puede tardar unos días más. El tipo de negocio y el país en el que te encuentres también pueden afectar a la velocidad de pago.

Iniciar el pago #

Puedes crear un pago con la API de Wooshpay. En general, hay dos escenarios para los pagos：.

1. Pagos globales
2. Pagos a China

Antes de crear un pago, es necesario especificar algunos parámetros:

• beneficiario : Los datos del beneficiario deben indicarse en este objeto, si se trata de un pago inicial que beneficiario_id no se utiliza. ) .
• tipo : El tipo debe ser empresa (para empresa) o beneficiario (para particulares)
• empresa : Se requieren los datos de la empresa, incluyendo nombre_registrado_de_la_empresa, dirección y información_adicional.
• beneficiario : Se requieren los datos de la empresa, incluyendo dirección, información_adicional.
• destino : Requiere la información de la cuenta bancaria o tarjeta a la que se envió el pago.

Pagos globales #

Crear un pago global

Para crear un nuevo Pago Global proporcionando directamente la información del beneficiario

A petición de la empresa

{
  "datos_beneficiario": {
    "tipo": "business",
    "business": {
      "company_registered_name": "XXX ltd",
      "address": {
        "línea1": "Bloque 3A",
        "line2": "Parque XX",
        "código_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"
      }
    }
  },
  "amount": 666,
  "currency": "cny",
  "description": "Puedes añadir la descripción aquí",
  "tipo": "cuenta_bancaria",
  "datos_destino": {
    "fuente": {
      "nombre_titular_cuenta": "xxxx ltd",
      "account_holder_type": "company",
      "bank_name": "Bank of America",
      "country": "USA",
      "currency": "USD",
      "account_number": "6210000000000002"
    }
  }
}

Respuesta

  {
      "id": "po_1654453881670729728",
      "objeto": "pago",
      "creado": 1683287519000,
      "moneda": "CNY",
      "importe": 666,
      "descripción": "Puedes añadir la descripción aquí",
      "estado": "pendiente",
      "destino": {
          "id": "ba_1654453883419754496",
          "objeto": "cuenta_bancaria",
          "creada": 1683287519000,
          "país": "USA",
          "moneda": "USD",
          "huella digital": "817902e3b6a2cf61eebc484f89467be650063413",
          "last4": "0002",
          "account_holder_name": "xxxx ltd",
          "account_holder_type": "company"
      },
      "livemode": falso,
      "type": "bank_account",
      "method": "standard",
      "beneficiario": {
          "id": "bf_1654453881691701248",
          "objeto": "beneficiario",
          "tipo": "business",
          "negocio": {
              "dirección": {
                  "ciudad": "Seattle",
                  "country": "USA",
                  "línea1": "Bloque 3A",
                  "line2": "Parque XX",
                  "state": "WA",
                  "código_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"
              }
          }
      }
  }

Solicitud individual
Para crear un pago facilitando directamente los datos del beneficiario

  {
    "datos_beneficiario": {
      "tipo": "beneficiario",
      "beneficiario":{
          "dirección": {
          "línea1": "### Ave",
          "line2": "#501",
          "código_postal": "98109",
          "city": "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": "[email protected]",
          "phone": "1234534343"
        }
      }
    },
    "importe": 1000,
    "moneda": "USD",
    "description": "Puedes añadir la descripción aquí",
    "tipo": "cuenta_bancaria",
    "datos_destino": {
      "fuente": {
        "nombre_titular_cuenta": "Leo Kale",
        "account_holder_type": "individual",
        "bank_name": "Bank of America",
        "country": "USA",
        "currency": "USD",
        "account_number": "6210000000000002"
      }
    }
  }

Respuesta

  {
      "id": "po_1654455721024028672",
      "object": "pago",
      "creado": 1683287958000,
      "moneda": "USD",
      "importe": 1000,
      "descripción": "Puedes añadir la descripción aquí",
      "estado": "pendiente",
      "destino": {
          "id": "ba_1654455722777247744",
          "objeto": "cuenta_bancaria",
          "creada": 1683287957000,
          "país": "USA",
          "moneda": "USD",
          "huella digital": "3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
          "last4": "0002",
          "account_holder_name": "Leo Kale",
          "account_holder_type": "individual"
      },
      "livemode": falso,
      "type": "bank_account",
      "method": "standard",
      "beneficiario": {
          "id": "bf_1654455721040805888",
          "objeto": "beneficiario",
          "tipo": "beneficiario",
          "beneficiario": {
              "dirección": {
                  "ciudad": "Seattle",
                  "country": "USA",
                  "line1": "### Ave",
                  "line2": "#501",
                  "state": "WA",
                  "código_postal": "98109"
              },
              "additional_info": {
                  "email": "[email protected]",
                  "phone": "1234534343",
                  "nombre": "LeoKale",
                  "apellido": "Kale",
                  "first_name": "Leo",
                  "id_type": "NATIONAL_ID",
                  "id_country_iso_code": "USA",
                  "id_number": "234242423423434X"
              }
          }
      }
  }

Pagos periódicos

Si ya ha pagado alguna vez al beneficiario, podría crear un pago utilizando beneficiario_id, destination_id que se guarda en el servidor y que puedes encontrar en la última respuesta.

En el caso anterior, beneficiario_id es "bf_1579357548861980672" y destination_id es "ba_1654455722777247744"

Solicitar

{
  "beneficiario": "bf_1579357548861980672",
  "importe": 888,
  "moneda": "USD",
  "descripción": "Puedes añadir la descripción aquí",
  "tipo": "cuenta_bancaria",
  "destino": "ba_1654455722777247744"
}

Pagos a China #

Crear un nuevo pago a China

La diferencia con los pagos globales es que tiene que enviar el payment_intents_id al solicitar un pago a China.

Solicitar

  {
    "beneficiario": "bf_1579357548861980672",
    "importe": 666,
    "moneda": "cny",
    "descripción": "Puedes añadir la descripción aquí",
    "tipo": "cuenta_bancaria",
    "datos_destino": {
      "fuente": {
        "nombre_titular_cuenta": "xxxx ltd",
        "account_holder_type": "company",
        "bank_name": "Bank of China",
        "country": "CN",
        "moneda": "CNY",
        "número_de_cuenta": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }

Crear un pago con documentos de conformidad

Si necesita enviarnos documentos de cumplimiento, hay tres pasos para crear un Pago con documentos de cumplimiento

1. Cargue los documentos de conformidad mediante Crear un archivo

Solicitar

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

Respuesta

  {
      "id": "file_1654416327596572672",
      "object": "archivo",
      "creado": 1683278565516,
      "url": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf",
      "tipo": "pdf",
      "filename": "1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
  }

2. Copie el URL en su respuesta En el caso anterior， el URL es https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf
3. Solicitar metadatos al pago creado

• metadatos : Consta de dos partes, la primera es el clave y la segunda parte es la valor.
• Ej: "metadatos": {"documento de cumplimiento": "url de su documento", "key2": "valor2", "...": "..." }

Solicitar

  {
      {
    "beneficiario": "bf_1579357548861980672",
    "metadatos": {
          "documento de cumplimiento": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },

    "importe": 666,
    "moneda": "cny",
    "descripción": "Puedes añadir la descripción aquí",
    "tipo": "cuenta_bancaria",
    "datos_destino": {
      "fuente": {
        "nombre_titular_cuenta": "xxxx ltd",
        "account_holder_type": "company",
        "bank_name": "Bank of China",
        "country": "CN",
        "moneda": "CNY",
        "número_de_cuenta": "6210000000000002"
      }
    },
    "payment_intents_id": [
      "pi_1577840204872417280"
    ]
  }
  }

Respuesta

  {
      "id": "po_1654421512435793920",
      "object": "pago",
      "creado": 1683279802000,
      "moneda": "CNY",
      "importe": 666,
      "descripción": "Puedes añadir la descripción aquí",
      "metadatos": {
          "documento de conformidad": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
      },
      "status": "pendiente",
      "destino": {
          "id": "ba_1654421514230956032",
          "objeto": "cuenta_bancaria",
          "creada": 1683279801000,
          "país": "CN",
          "moneda": "CNY",
          "huella digital": "4732b34681776e6b2383da452cbbabbcd2228d48",
          "last4": "0002",
          "account_holder_name": "xxxx ltd",
          "account_holder_type": "company"
      },
      "livemode": falso,
      "type": "bank_account",
      "method": "standard",
      "beneficiario": {
          "id": "bf_1654421512456765440",
          "objeto": "beneficiario",
          "tipo": "business",
          "negocio": {
              "dirección": {
                  "ciudad": "Beijing",
                  "country": "CN",
                  "línea1": "Bloque 3A",
                  "línea2": "Parque XX",
                  "estado": "Beijing",
                  "código_postal": "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"
      ]
  }

Fallos en los pagos #

Si la cuenta bancaria no puede recibir un pago por cualquier motivo, el banco nos devuelve los fondos. Este nos devuelve un error con el motivo del fallo. El banco puede tardar varios días laborables en devolver el pago e informarnos de que ha fallado. Si esto ocurre, se le notificará en el Panel de control. Asegúrate de que la información de la cuenta bancaria que facilitas es correcta. Si no lo es (un error tipográfico en el número de cuenta, por ejemplo), es posible que los pagos se envíen al titular de otra cuenta bancaria.

Pagos negativos #

Cada pago refleja el saldo disponible de su cuenta en el momento en que se creó. En algunos casos, puede tener un saldo de cuenta negativo. Por ejemplo, si recibes 100 USD en pagos pero devuelves 200 USD de pagos anteriores, el saldo de tu cuenta sería de -100 USD. Si no recibes más pagos para equilibrar la cantidad negativa, fallará un nuevo pago.

Conozca los resultados de su pago #

Para saber si un pago a una cuenta bancaria se ha realizado correctamente, debe configurar un webhook.

Los siguientes tipos de eventos son importantes cuando realiza pagos a cuentas bancarias, y puede crear webhooks para conocer el estado de su pago.

• pago.cancelado: Se produce cada vez que se cancela un pago.
• pago.creado: Se produce cada vez que se crea un pago.
• pago.fallido: Se produce cuando falla un intento de pago.
• pago.pagado: Se produce siempre que se espera que un pago esté disponible en la cuenta de destino. Si el pago falla, también se envía una notificación payout.failed, en un momento posterior.
• pago.actualizado: Se produce cada vez que se actualiza un pago.

Una vez identificados los eventos que desea supervisar, puede consultar la guía de webhooks para Crear un webhook.

Pagos instantáneos #

Con los Pagos Instantáneos, el envío de fondos a una cuenta bancaria admitida (en el Reino Unido) puede procesarse en un día. Puede solicitar pagos instantáneos cualquier día u hora, incluidos fines de semana y festivos, y los fondos suelen aparecer en la cuenta bancaria asociada.