鲲

Português do Brasil
Português do Brasil English 简体中文 日本語 한국어 Español Italiano Français
Fazer login

Alipay Plus

Índice

Pagamentos Alipay Plus #

A Alipay Plus é uma carteira digital da China que atende a clientes do sudeste asiático e da China. Os usuários do Alipay Plus podem pagar na Web ou em um dispositivo móvel usando credenciais de login ou um aplicativo específico compatível com o Alipay Plus.

Características #

Localizações de clientes

  • Consumidores chineses
  • Chinês no exterior
  • Viajantes chineses
  • Consumidores do Sudeste Asiático

Moeda de apresentação
CNY, HKD, GBP, IDR, MYR, PHP, THB

Lista de carteiras

  1. AlipayHK
  2. DANA
  3. TNG
  4. BPI
  5. Rabbit LINE Pay
  6. GCash
  7. Impulsionar
  8. Akulaku PayLater

Categorias de negócios proibidas
Tanto o WooshPay quanto o Alipay Plus mantêm uma lista de empresas proibidas que não têm permissão para usar seus serviços. Para usar o Alipay Plus no WooshPay, sua empresa não pode estar impedida de usar o Stripe nem constar da lista de empresas proibidas do Alipay. Se não tiver certeza se sua empresa é uma empresa proibida ou se tiver dúvidas sobre como esses requisitos se aplicam a você, entre em contato com [email protected].

Integração de servidor para servidor #

Usando o Alipay Plus, os clientes pagam redirecionando a partir do seu site ou aplicativo, autorizam o pagamento por meio de uma carteira diferente e, em seguida, retornam ao seu site ou aplicativo, onde você recebe uma notificação imediata sobre o sucesso ou fracasso do pagamento.

Visão geral #

Para integração direta com a API, você pode criar a intenção de pagamento e obter o URL em apenas uma etapa:

  1. Criar uma intenção de pagamento
  2. Reembolso
  3. Webhook

1. Criar um PaymentIntent #

Um PaymentIntent é um objeto que representa sua intenção de cobrar o pagamento do cliente e rastreia o ciclo de vida do processo de pagamento. Crie um PaymentIntent em seu servidor e especifique o valor a ser cobrado e uma moeda compatível. Se você já tiver uma integração de Payment Intents, adicione o alipayplus à lista de tipos de métodos de pagamento.

Solicitação Criar um PaymentIntent

{
    "amount":200,
    "currency": "IDR", //moeda diferente pode resultar em uma carteira diferente
    "confirm":true,
    "payment_method_options":{
        "alipayplus":{
            "terminal_type": "WEB"
        }
    },
    "payment_method_data":{
        "type": "alipayplus"
    },
    "return_url": "https://wooshpay.com"
}

Resposta

{
    "id": "pi_1646355176136638464",
    "object": "payment_intent",
    "created": 1681356636000,
    "currency": "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" (cartão),
        "alipayplus"
    ],
    "confirmation_method": "automatic",
    "payment_method_options": {
        "alipayplus": {
            "terminal_type": "WEB"
        }
    },
    "return_url": "https://wooshpay.com",
    "payment_method": "pm_1646355176006615040",
    "capture_method": "automatic"
}

O normalUrl de próxima_ação pode ser aberto, a partir do link, o cliente verá uma carteira diferente com base na moeda, e o cliente pode escolher a que deseja pagar, escanear o código QR ou fazer login na carteira.

2. Reembolso #

Você pode reembolsar parcial ou totalmente qualquer pagamento bem-sucedido, usando a API ou o Dashboard. Para visualizar uma lista de todos os seus reembolsos, acesse a página Refunded payments (Pagamentos reembolsados) no Dashboard.

Para reembolsar um pagamento usando a API, crie um reembolso fornecendo o PaymentIntent.

Solicitação Criar um reembolso

{
    "reason": "requested_by_customer",
    "payment_intent":"pi_1575055712604651520"
}

Resposta

{
    "id":"re_1575092157281206272",
    "object": "refund",
    "created":1664366209000,
    "amount":20,
    "currency": "CNY",
    "metadata":null,
    "reason": "requested_by_customer",
    "status": "successful" (bem-sucedido),
    "description":null,
    "payment_intent":"pi_1575055712604651520",
    "failure_reason":null
}

3. Webhook #

Ouça os eventos em sua conta WooshPay para que sua integração possa acionar reações automaticamente. Crie um webhook que se concentre principalmente em eventos_habilitados e url.

Etapas para receber um webhook:

  1. Identifique os eventos que deseja monitorar e as cargas úteis de eventos a serem analisadas.
  2. Crie um ponto de extremidade de webhook como um ponto de extremidade HTTP (URL) em seu servidor local.
  3. Teste se o ponto de extremidade do webhook está funcionando corretamente e veja se você recebeu um retorno de chamada.

Solicitação

{
    "url": "https://apitest.wooshpay.com/v1/receives",
    "description": "I_am_description",
    "enabled_events":[
        "payment_intent.created",
        "payment_intent.payment_failed",
        "payment_intent.succeeded",
        "charge.refund.updated"
    ],
    "api_version":"1.0.1"
}

Resposta

{
    "id":"we_1575093135514533888",
    "object": "webhook_endpoint",
    "created":1664366442000,
    "description": "I_am_description",
    "metadata":null,
    "status": "ativado",
    "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",
        "charge.refund.updated"
    ]
}

Checkout #

Para oferecer suporte a pagamentos do Alipayplus, uma sessão de checkout deve atender a todas as condições a seguir:

  • Os preços de todos os itens de linha devem estar na mesma moeda.
    Se você tiver itens de linha em moedas diferentes, crie sessões de checkout separadas para cada moeda.
  • Você só pode usar itens de linha únicos.

Ativar o Alipayplus como um método de pagamento #

Ao criar uma nova sessão de checkout, você precisa:

Adicione a Alipayplus à lista de payment_method_types.
Certifique-se de que todos os itens_linha usam a mesma moeda.

Solicitação Criar uma sessão

{
    "cancel_url": "www.baide.com",
    "mode": "payment" (pagamento),
    "success_url": "www.wooshpay.com",
    "payment_method_options": { //adicionar alipayplus como método de pagamento
        "alipayplus": {
            "terminal_type": "WEB"
        }
    },
    "line_items": [
        {
            "price_data": {
                "currency" (moeda): "GBP",
                "product": nulo,
                "unit_amount": 5,
                "active": true,
                "metadata": {
                    "key1": "value1",
                    "key2": "value2"
                },
                "nickname": "fengli",
                "product_data": {
                    "id": nulo,
                    "name": "taiwan fengli",
                    "active": true,
                    "description" (descrição): "muito delicioso",
                    "metadata": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "url": "www.baidu.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1597163428114333696",
    "object": "checkout.session",
    "created": 1669628410000,
    "currency": "GBP",
    "customer": "",
    "mode": "payment" (pagamento),
    "livemode": true,
    "shipping": nulo,
    "status": "open",
    "url": "https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
    "cancel_url": "www.baidu.com",
    "client_reference_id": nulo,
    "customer_email": nulo,
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1597163428139499520",
                "object": "item",
                "currency": "GBP",
                "description": "taiwan fengli",
                "price" (preço): {
                    "id": "price_1597163428152082432",
                    "object": "price" (preço),
                    "created": 1669628410000,
                    "active": true,
                    "currency": "GBP",
                    "metadata": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "nickname": "fengli",
                    "product": {
                        "id": "prod_1597163428164665344",
                        "object": "product" (produto),
                        "created" (criado): 1669628410000,
                        "active": true,
                        "description" (descrição): "muito delicioso",
                        "metadata": {
                            "key1": "value1",
                            "key2": "value2"
                        },
                        "name": "taiwan fengli",
                        "livemode": true,
                        "url": "www.baidu.com",
                        "updated" (atualizado): 1669628410000,
                        "images": null
                    },
                    "type" (tipo): "one_time",
                    "livemode": true,
                    "unit_amount": 5,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 5,
                "amount_total": 5
            }
        ],
        "url": nulo,
        "has_more": null
    },
    "payment_intent": "pi_1597163428336631808",
    "payment_method_types": nulo,
    "payment_status": "unpaid" (não pago),
    "success_url": "www.wooshpay.com",
    "amount_subtotal": 5,
    "amount_total": 5,
    "billing_address_collection": "auto",
    "expires_at": 1669714809783,
    "payment_link": "",
    "payment_method_options": nulo,
    "phone_number_collection": nulo,
    "shipping_address_collection": nulo,
    "client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}

A url direcionará o cliente para a página de checkout do WooshPay, o cliente verá uma carteira diferente com base na moeda, e o cliente poderá escolher a que deseja pagar, escanear o código QR ou fazer login na carteira.

Quais são seus sentimentos?
Atualizado em 8 de agosto de 2023