Pagos Alipay Plus #
Alipay Plus es un monedero digital de China que atiende a clientes del sudeste asiático y China. Los usuarios de Alipay Plus pueden pagar en la web o en un dispositivo móvil utilizando credenciales de inicio de sesión o una aplicación específica compatible con Alipay Plus.
Características #
Ubicación de los clientes
- Consumidores chinos
- Chinos de ultramar
- Viajeros chinos
- Consumidores del sudeste asiático
Moneda de presentación
CNY, HKD, GBP, IDR, MYR, PHP, THB
Lista de carteras
- AlipayHK
- DANA
- TNG
- BPI
- Rabbit LINE Pay
- GCash
- Aumentar
- Akulaku PayLater
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 restringido el uso de Stripe ni aparecer en la lista de empresas prohibidas de Alipay. Si no está seguro de si su empresa es una empresa prohibida o tiene alguna pregunta sobre cómo se aplican estos requisitos en su caso, póngase en contacto con [email protected].
Integración de servidor a servidor #
Con Alipay Plus, los clientes pagan redirigiéndose desde su sitio web o aplicación, autorizan el pago a través de un monedero diferente y, a continuación, vuelven a su sitio web o aplicación, donde recibirá una notificación inmediata sobre si el pago se ha realizado correctamente o no.
Visión general #
Para la integración directa de la API, puede crear la intención de pago y obtener la url en un solo paso, la siguiente es la demostración de la creación de intenciones de pago:
- Crear una intención de pago
- Reembolso
- Gancho web
1. Crear una PaymentIntent #
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. Si ya dispone de una integración de PaymentIntents, añada alipayplus a la lista de tipos de métodos de pago.
Solicitar Crear una PaymentIntent
{
"importe":200
"moneda": "IDR", //diferentes monedas pueden resultar en diferentes monederos
"confirm":true
"payment_method_options":{
"alipayplus":{
"terminal_type": "WEB"
}
},
"payment_method_data":{
"type": "alipayplus"
},
"return_url": "https://wooshpay.com"
}Respuesta
{
"id": "pi_1646355176136638464",
"object": "payment_intent",
"creado": 1681356636000,
"moneda": "IDR",
"amount": 200,
"status": "requires_action",
"livemode": true
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action": {
"alipayplus_handle_redirect": {
"normalUrl": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"payment_method_types": [
"alipay",
"wechat_pay",
"card",
"alipayplus"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipayplus": {
"terminal_type": "WEB"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1646355176006615040",
"capture_method": "automatic"
}La normalUrl de siguiente_acción se puede abrir, desde el enlace, se mostrará al cliente un monedero diferente en función de la divisa, y el cliente podrá elegir el que desee pagar, bien escaneando el código QR o iniciando sesión en el monedero.
2. Reembolso #
Puede reembolsar parcial o totalmente cualquier pago realizado con éxito, ya sea mediante la API o el Panel de control. Para ver una lista de todos sus reembolsos, vaya a la página Pagos reembolsados en el Panel de control.
Para reembolsar un pago utilizando la API, cree un reembolso proporcionando el PaymentIntent.
Solicitar Crear un reembolso
{
"motivo": "solicitado_por_el_cliente",
"payment_intent":"pi_1575055712604651520"
}Respuesta
{
"id":"re_1575092157281206272",
"objeto": "reembolso",
"created":1664366209000,
"importe":20
"moneda": "CNY",
"metadatos":null,
"motivo": "solicitado_por_el_cliente",
"estado": "correcto",
"description":null,
"payment_intent":"pi_1575055712604651520",
"failure_reason":null
}3. Gancho web #
Escuche eventos en su cuenta WooshPay para que su integración pueda desencadenar reacciones automáticamente. Cree un webhook que se centre principalmente en eventos_habilitados y url.
Pasos para recibir un webhook:
- Identifique los eventos que desea supervisar y las cargas útiles de los eventos que desea analizar.
- Cree un punto final webhook como un punto final HTTP (URL) en su servidor local.
- Compruebe que su punto final de webhook funciona correctamente y si ha recibido una devolución de llamada.
Solicitar
{
"url": "https://apitest.wooshpay.com/v1/receives",
"description": "I_am_description",
"enabled_events":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"cargo.reembolso.actualizado"
],
"api_version":"1.0.1"
}Respuesta
{
"id":"we_1575093135514533888",
"object": "webhook_endpoint",
"created":1664366442000,
"description": "I_am_description",
"metadata":null,
"status": "enabled",
"url": "https://apitest.wooshpay.com/v1/receives",
"livemode":false,
"api_version":"1.0.1",
"enabled_events":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"cargo.reembolso.actualizado"
]
}Pedido #
Para admitir pagos Alipayplus, 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 partidas en distintas divisas, cree Sesiones de pago separadas para cada divisa. - Sólo puede utilizar partidas únicas.
Habilitar Alipayplus 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 los artículos_de_línea utilizan la misma moneda.
Solicitar Crear una sesión
{
"cancel_url": "www.baide.com",
"mode": "pago",
"success_url": "www.wooshpay.com",
"payment_method_options": { //añadir alipayplus como método de pago
"alipayplus": {
"terminal_type": "WEB"
}
},
"line_items": [
{
"price_data": {
"currency": "GBP",
"product": null,
"unit_amount": 5,
"activo": true
"metadatos": {
"clave1": "valor1",
"key2": "valor2"
},
"nickname": "fengli",
"product_data": {
"id": null
"name": "taiwan fengli",
"active": true,
"descripción": "muy delicioso",
"metadata": {
"clave1": "valor1",
"key2": "valor2"
},
"url": "www.baidu.com"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantity": 1
}
]
}Respuesta
{
"id": "cs_1597163428114333696",
"object": "checkout.session",
"creado": 1669628410000,
"currency": "GBP",
"cliente": "",
"modo": "pago",
"livemode": true,
"shipping": null,
"estado": "abierto",
"url": "https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url": "www.baidu.com",
"client_reference_id": null,
"customer_email": null,
"line_items": {
"object": "lista",
"data": [
{
"id": "li_1597163428139499520",
"object": "artículo",
"moneda": "GBP",
"descripción": "taiwan fengli",
"precio": {
"id": "price_1597163428152082432",
"object": "precio",
"creado": 1669628410000,
"activo": true
"moneda": "GBP",
"metadatos": {
"clave1": "valor1",
"key2": "valor2"
},
"nickname": "fengli",
"producto": {
"id": "prod_1597163428164665344",
"objeto": "producto",
"creado": 1669628410000,
"activo": true
"descripción": "muy delicioso",
"metadata": {
"clave1": "valor1",
"key2": "valor2"
},
"name": "taiwan fengli",
"livemode": true
"url": "www.baidu.com",
"updated": 1669628410000,
"images": null
},
"type": "one_time",
"livemode": true
"unit_amount": 5,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"quantity": 1,
"amount_subtotal": 5,
"amount_total": 5
}
],
"url": null
"has_more": null
},
"payment_intent": "pi_1597163428336631808",
"payment_method_types": null,
"payment_status": "unpaid",
"success_url": "www.wooshpay.com",
"amount_subtotal": 5,
"amount_total": 5,
"billing_address_collection": "auto",
"expires_at": 1669714809783,
"payment_link": "",
"payment_method_options": null,
"phone_number_collection": null,
"shipping_address_collection": null,
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}La url dirigirá al cliente a la página de pago de WooshPay, se le mostrará un monedero diferente en función de la divisa y el cliente podrá elegir la que desee pagar, escanear el código QR o iniciar sesión en el monedero.
