Conozca Alipay, un monedero digital muy popular entre los clientes de China. #
Alipay es un monedero digital de China que cuenta con más de mil millones de usuarios activos en todo el mundo. Los usuarios de Alipay pueden pagar en la web o en un dispositivo móvil utilizando credenciales de inicio de sesión o su aplicación Alipay. Alipay tiene un bajo índice de impugnaciones y reduce el fraude autenticando los pagos con las credenciales de inicio de sesión del cliente.
Características #
Ubicación de los clientes | Consumidores chinos Chinos de ultramar Viajeros chinos |
---|---|
Tratamiento de divisas | CNY, GBP, USD, EUR, HKD |
Divisas de liquidación | GBP,HKD,EUR |
Importe mínimo de transacción | 0,01 CNY |
Importe máximo de la transacción | Sin límite |
Reembolsos | ✅ |
Reembolsos parciales | ✅ |
Reembolso parcial múltiple | ❌ |
Contracargo | ❌ |
Categorías de empresas prohibidas Tanto WooshPay como Alipay Plus mantienen una lista de empresas prohibidas que no pueden utilizar sus servicios. Para utilizar Alipay Plus en WooshPay, su empresa no puede tener restricciones de uso ni figurar en la lista de empresas prohibidas de Alipay. Si no está seguro de si su negocio es un negocio prohibido, o tiene preguntas sobre cómo se aplican estos requisitos en su caso, póngase en contacto con [email protected].
Subproductos #
Producto | Descripción de los escenarios de pago |
---|---|
Pago por Internet | En el navegador de escritorio, tras seleccionar Alipay como método de pago, aparece un código QR. A continuación, el comprador abre la aplicación de Alipay en su teléfono móvil y escanea el código de barras que aparece en la página del navegador para completar el pago. |
Pago APP | En el navegador del móvil, el comprador selecciona Alipay como método de pago en la caja del comercio y es redirigido desde el navegador a la aplicación de Alipay para completar el pago antes de ser redirigido de nuevo al navegador del comercio. |
Flujo de pagos #
Pago por Internet #
Pago APP #
Método de integración #
Valores de la enumeración del método de pago: alipay
Existen dos métodos de integración para Alipay
- API directa
- Pedido
Método de integración | escenarios de pago | valores de la enumeración terminal_type |
---|---|---|
API directa | Pago por Internet | WEB |
API directa | Pago APP | APP |
Pedido | Pago por Internet | No es necesario identificar el tipo_terminal en la caja. La caja generará automáticamente un código QR o redirigirá a la aplicación Alipay en función del dispositivo. |
Pedido | Pago APP | No es necesario identificar el tipo_terminal en la caja. La caja generará automáticamente un código QR o redirigirá a la aplicación Alipay en función del dispositivo. |
API directa #
Un PaymentIntent es un objeto que representa su intención de cobrar el pago de su cliente y realiza un seguimiento del ciclo de vida del proceso de pago. Cree un PaymentIntent en su servidor y especifique el importe a cobrar y una divisa admitida.
Crear una PaymentIntent #
Para la integración directa de la API, puede crear PaymentIntent y obtener la url en un solo paso. La siguiente es la demostración de la creación de intentos de pago:
- Pago por Internet
- Pago APP
Puede controlar los escenarios de pago generados en Payment Intent cambiando los valores de enumeración del tipo de terminal:.payemen_method_options.alipay.terminal_type
Pago por Internet #
Solicitar
{
"importe": 20,
"moneda": "CNY",
"confirm": true
"payment_method_options": {
"alipay": {
"client_ip": "192.168.0.1",
"terminal_type": "WEB",
"os_type": "IOS"
}
},
"payment_method_data": {
"type": "alipay"
},
"payment_method_types": [
"alipay"
],
"return_url": "https://wooshpay.com"
}
Respuesta
{
"id": "pi_1666729870215872512",
"object": "payment_intent",
"creado": 1686214342000,
"moneda": "CNY",
"importe": 20,
"estado": "requires_action",
"livemode": true,
"client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
"next_action": {
"tipo": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "WEB",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666729870102626304",
"capture_method": "automatic"
}
En url
desde next_action se puede abrir, desde el enlace, el cliente será redirigido a la página de pago de Alipay. El cliente puede escanear el código QR o iniciar sesión en el monedero para pagar.
Pago APP #
Solicitar
{
"importe": 20,
"moneda": "CNY",
"confirm": true
"payment_method_options": {
"alipay": {
"client_ip": "192.168.0.1",
"terminal_type": "APP",
"os_type": "IOS"
}
},
"payment_method_data": {
"type": "alipay"
},
"payment_method_types": [
"alipay"
],
"return_url": "https://wooshpay.com"
}
Respuesta
{
"id": "pi_1666732544285999104",
"object": "payment_intent",
"created": 1686214980000,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
"next_action": {
"type": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "APP",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666732544155975680",
"capture_method": "automatic"
}
Pedido #
Para admitir pagos con Alipay, una sesión de pago debe cumplir todas las condiciones siguientes:
- Los precios de todas las partidas deben estar en la misma moneda. Si tiene artículos en distintas divisas, cree sesiones de pago distintas para cada divisa.
- Sólo puede utilizar partidas únicas.
Habilitar Alipay como método de pago
Al crear una nueva sesión de pago, debe:
Añadir Alipayplus a la lista de tipos_de_método_de_pago
. Asegúrese de que todos artículos_de_línea
utilizan la misma moneda.
Crear una sesión #
No es necesario identificar el tipo_terminal cuando cree una sesión de pago. El proceso de pago generará automáticamente un código QR o redirigirá a la aplicación Alipay en función del dispositivo.
Solicitar
{
"cancel_url": "www.baidu.com",
"mode": "pago",
"success_url": "https://wooshpay.com/",
"payment_method_types": [
"alipay"
],
"line_items": [
{
"price_data": {
"moneda": "CNY",
"unit_amount": 100000,
"activo": true,
"product_data": {
"name": "taiwan fengli"
},
"esquema_facturación": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantity": 1
}
]
}
Respuesta
{
"id": "cs_1666733999608823808",
"object": "checkout.session",
"creado": 1686215327000,
"moneda": "CNY",
"cliente": "",
"modo": "pago",
"livemode": true,
"status": "abierto",
"url": "https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url": "www.baidu.com",
"line_items": {
"object": "lista",
"data": [
{
"id": "li_1666733999642378240",
"object": "item",
"moneda": "CNY",
"descripción": "taiwan fengli",
"precio": {
"id": "price_1666733999659155456",
"object": "precio",
"creado": 1686215327000,
"activo": true
"moneda": "CNY",
"producto": {
"id": "prod_1666733999675932672",
"objeto": "producto",
"creado": 1686215327000,
"activo": true
"nombre": "taiwan fengli",
"livemode": true,
"updated": 1686215327000
},
"type": "one_time",
"livemode": true,
"unit_amount": 100000,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"quantity": 1,
"amount_subtotal": 100000,
"amount_total": 100000
}
]
},
"payment_intent": "pi_1666733999864676352",
"payment_method_types": [
"alipay"
],
"payment_status": "unpaid",
"success_url": "https://wooshpay.com/",
"amount_subtotal": 100000,
"amount_total": 100000,
"billing_address_collection": "auto",
"expires_at": 1686301726587,
"payment_link": "",
"client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}
En url
desde next_action se puede abrir, desde el enlace, el cliente será redirigido a la página de pago de Alipay. El cliente puede escanear el código QR o iniciar sesión en el monedero para pagar.
Siguiente paso #
Puede añadir más funciones a su integración en función de sus necesidades
Crear un Webhook #
Escuche los eventos de su cuenta WooshPay para que su integración pueda desencadenar reacciones automáticamente. Crea un webhook que se centre principalmente en enabled_events y url.
Crear una devolución #
Cree un reembolso para devolver los fondos a su cliente. También puede realizar reembolsos parciales, pero no todos los métodos de pago los admiten. Un reembolso parcial consiste en devolver sólo una parte del importe de la transacción original.