Saiba mais sobre a PayNow, uma rede de pagamento em tempo real popular em Cingapura. #

A PayNow é uma rede de pagamentos em tempo real em Cingapura, administrada pelo Association Bank of Singapore (ABS) e supervisionada pela Monetary Authority of Singapore (MAS). Ela permite que consumidores e empresas se registrem no serviço usando vários identificadores, como número de celular, NRIC/FIN de Cingapura, número de registro comercial UEN ou endereço de pagamento virtual (VPA para contas NFI, que inclui carteiras eletrônicas). Uma vez registrados, os usuários podem transferir facilmente fundos em SGD de uma conta bancária ou de carteira eletrônica para outra em Cingapura por meio da rede FAST. O FAST é um sistema de trilhos de pagamento regulamentado e padronizado que garante uma interoperabilidade perfeita entre diferentes provedores de pagamento.

Recursos #

Fluxo de pagamento #

Método de integração #

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

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

1. API direta
2. Checkout

Direto API #

Como fazer a integração #

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

Criar um PaymentIntent

Crie um PaymentIntent em seu servidor e especifique o valor a ser coletado e uma moeda compatível.

Notavelmente, para o Paynow, você também precisa coletar os dados do cliente nome, país e e-mail em payment_method_data.billing_details.

Se você tiver uma integração existente com o Payment Intents, adicione bank_transfer_uk à lista de tipos de métodos de pagamento.

Solicitação Criar um PaymentIntent

{
    "amount":1000,
    "currency": "SGD",
    "payment_method_data" : {
        "type": "paynow",
        "billing_details":{
            "address": {
                "country": "SG"
            },
            "name": "Tom Elis",
            "email": "1231536GF41@Gmail.com"
        }
    },
    "description" (descrição): "descrição do produto",
    "quantity" (quantidade): 2,
    "return_url": "https://your.website"
}

Resposta

{
    "id": "pi_1686226704999120896",
    "object": "payment_intent",
    "created": 1690862750000,
    "livemode": true,
    "currency": "SGD",
    "amount" (valor): 1000,
    "status": "requires_action",
    "description" (descrição): "descrição do produto",
    "quantity" (quantidade): 2,
    "client_secret": "pi_1686226704999120896_secret_nz79AKtKGcxWr2gUxEsFXrM1",
    "next_action": {
        "type": "paynow_handle_redirect",
        "paynow_handle_redirect": {
            "url": "https://pay.tazapay.com/marketplace/paymentdetails/0Pq7kWaNrGrjxYiaqsfchBD3bR0K4obPc7W4EtdSmt6y9BHpRLFBYdPzUWx59sHR"
        }
    },
    "payment_method_types": [
        "paynow"
    ],
    "confirmation_method" (método de confirmação): "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1686226704869097472",
    "capture_method": "automatic"
}

Checkout #

Criar uma seção #

Solicitação Criar uma sessão

{
    "cancel_url": "www.wooshpay.com",
    "mode": "payment" (pagamento),
    "success_url": "https://wooshpay.com/",
    "payment_method_types":["paynow"],
    "line_items": [
        {
            "price_data": {
                "currency": "SGD",
                "unit_amount": 10000000,
                "nickname": "apple",
                "product_data": {
                    "name": "apple"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1686257953583136768",
    "object": "checkout.session",
    "created": 1690870200000,
    "livemode": falso,
    "currency": "SGD",
    "customer": "",
    "mode" (modo): "payment" (pagamento),
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1686257953583136768?key=cGtfdGVzdF9OVEUyTlRjNU5ESXpNalUxTXpNME56ZzVNVE14T2pNemIxTTJhVVZrTmtOdmFsWlBSRTFuVFc1SVREaFljREUyT0RReE1Ua3lNamd6TVRR",
    "cancel_url": "www.wooshpay.com",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1686257953620885504",
                "object": "item",
                "currency": "SGD",
                "description": "apple",
                "price": {
                    "id": "price_1686257953633468416",
                    "object": "price" (preço),
                    "created": 1690870200000,
                    "livemode": falso,
                    "active": falso,
                    "currency" (moeda): "SGD",
                    "nickname": "apple",
                    "product" (produto): {
                        "id": "prod_1686257953646051328",
                        "object": "product",
                        "created" (criado): 1690870200000,
                        "livemode": falso,
                        "active": falso,
                        "name" (nome): "apple",
                        "updated": 1690870200000
                    },
                    "type" (tipo): "one_time",
                    "unit_amount": 10000000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 10000000,
                "amount_total": 10000000
            }
        ]
    },
    "payment_intent": "pi_1686257953868349440",
    "payment_method_types": [
        "paynow"
    ],
    "payment_status": "unpaid" (não pago),
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 10000000,
    "amount_total": 10000000,
    "billing_address_collection": "auto",
    "expires_at": 1690956599952,
    "payment_link": "",
    "client_secret": "pi_1686257953868349440_secret_BKuEOd8kJq0cxvZszocDlfjb"
}

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.