Saiba mais sobre o Alipay, uma carteira digital popular entre os clientes da China. #

A Alipay é uma carteira digital da China que tem mais de um bilhão de usuários ativos em todo o mundo. Os usuários da Alipay podem pagar na Web ou em um dispositivo móvel usando as credenciais de login ou o aplicativo da Alipay. A Alipay tem uma baixa taxa de contestação e reduz a fraude ao autenticar os pagamentos usando as credenciais de login do cliente.

Recursos #

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 ter restrições de uso 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 essas exigências se aplicam a você, entre em contato com [email protected].

Subprodutos #

Fluxo de pagamento #

Pagamento pela Web #

Pagamento do APP #

Método de integração #

Valores de enumeração do método de pagamento: alipay

Há dois métodos de integração para o Alipay

1. API direta
2. Checkout

API direta #

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.

Criar um PaymentIntent #

Para a integração direta com a API, você pode criar o PaymentIntent e obter o URL em apenas uma etapa. Veja a seguir a demonstração da criação de intenções de pagamento:

• Pagamento pela Web
• Pagamento APP

Você pode controlar os cenários de pagamento gerados na Intenção de Pagamento alterando os valores de enumeração do tipo de terminal：payemen_method_options.alipay.terminal_type

Pagamento pela Web #

Solicitação

{
    "amount": 20,
    "currency" (moeda): "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"
}

Resposta

{
    "id": "pi_1666729870215872512",
    "object": "payment_intent",
    "created": 1686214342000,
    "currency": "CNY",
    "amount": 20,
    "status": "requires_action",
    "livemode": true,
    "client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
    "next_action": {
        "type": "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" (método de confirmação): "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"
}

O url a partir da next_action pode ser aberto, a partir do link, o cliente será redirecionado para a página de checkout da Alipay. O cliente pode escanear o código QR ou fazer login na carteira para pagar.

Pagamento APP #

Solicitação

{
    "amount": 20,
    "currency" (moeda): "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"
}

Resposta

{
    "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"
}

Checkout #

Para oferecer suporte a pagamentos do Alipay, 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 Alipay 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.

Criar uma sessão #

Não é necessário identificar o tipo_de_terminal quando você criar uma sessão de checkout. O checkout gerará automaticamente um código QR ou redirecionará para o aplicativo Alipay com base em seu dispositivo.

Solicitação

{
    "cancel_url": "www.baidu.com",
    "mode": "payment" (pagamento),
    "success_url": "https://wooshpay.com/",
    "payment_method_types": [
        "alipay"
    ],
    "line_items": [
        {
            "price_data": {
                "currency" (moeda): "CNY",
                "unit_amount": 100000,
                "active": true,
                "product_data": {
                    "name": "taiwan fengli"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1666733999608823808",
    "object": "checkout.session",
    "created": 1686215327000,
    "currency": "CNY",
    "customer": "",
    "mode" (modo): "payment" (pagamento),
    "livemode": true,
    "status": "open",
    "url": "https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
    "cancel_url": "www.baidu.com",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1666733999642378240",
                "object": "item",
                "currency": "CNY",
                "description": "taiwan fengli",
                "price" (preço): {
                    "id": "price_1666733999659155456",
                    "object": "price" (preço),
                    "created": 1686215327000,
                    "active": true,
                    "currency" (moeda): "CNY",
                    "product": {
                        "id": "prod_1666733999675932672",
                        "object": "product",
                        "created" (criado): 1686215327000,
                        "active": true,
                        "name" (nome): "taiwan fengli",
                        "livemode": true,
                        "updated" (atualizado): 1686215327000
                    },
                    "type" (tipo): "one_time",
                    "livemode": true,
                    "unit_amount": 100000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 100000,
                "amount_total": 100000
            }
        ]
    },
    "payment_intent": "pi_1666733999864676352",
    "payment_method_types": [
        "alipay"
    ],
    "payment_status": "unpaid" (não pago),
    "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"
}

O url a partir da next_action pode ser aberto, a partir do link, o cliente será redirecionado para a página de checkout da Alipay. O cliente pode escanear o código QR ou fazer login na carteira para pagar.

Próxima etapa #

Você pode adicionar mais recursos à sua integração conforme necessário

Criar um 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 enabled_events e url.

Criar um reembolso #

Crie um reembolso para devolver os fundos ao seu cliente. Você também pode realizar reembolsos parciais, mas nem todos os métodos de pagamento os aceitam. Um reembolso parcial é quando você reembolsa apenas parte do valor original da transação.