Adicionar formas de pagamento externas

Adicione formas de pagamento externas ao Mobile Payment Element para dispositivos móveis.

Observação

Criamos um recurso de formas de pagamento personalizadas que permite ampliar a integração com formas de pagamento processadas fora do Stripe. Recomendamos usá-lo para sua integração em vez de formas de pagamento externas.

O Mobile Payment Element pode exibir formas de pagamento externas aceitas por você, além das formas de pagamento processadas pela Stripe. A integração de formas de pagamento externas exige trabalho adicional de integração, pois as transações de formas de pagamento externas são processadas e finalizadas fora da Stripe.

Responsabilidade por formas de pagamento externas

Quando os clientes escolhem uma forma de pagamento externa, seu aplicativo processa o pagamento em vez da Stripe. Para saber mais sobre suas responsabilidades e a disponibilidade contínua de formas de pagamento externas, consulte o aviso legal sobre formas de pagamento externas.

Este guia adiciona uma forma de pagamento externa, Fawry, usando o guia de pagamentos no aplicativo Payment Sheet. Veja a lista de todas as formas de pagamento externas disponíveis.

Antes de começar

Crie uma conta Stripe ou faça login.
Siga o exemplo Payment Sheet para concluir uma integração de pagamentosใ
Para cada forma de pagamento externa que você deseja adicionar, conclua a integração e confirme se está funcionando na região em que deseja habilitá-la.

Adicionar tipos de forma de pagamento externa

Quando você criar seu objeto PaymentSheet.Configuration e inicializar PaymentSheet, especifique as formas de pagamento externas que você deseja adicionar ao Payment Element e um gerenciador para concluir o pagamento. Este exemplo adiciona Fawry:

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
  func setUpPaymentSheet() {
      // ...
      var configuration = PaymentSheet.Configuration()
      configuration.externalPaymentMethodConfiguration = .init(
          externalPaymentMethods: ["external_fawry"]
      ) { externalPaymentMethodType, billingDetails, completion in
          self.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
      }
      // ...
  }

  func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
      // ...explained in the next step
  }
}

Finalizar o pagamento

Quando o cliente toca no botão Comprar no PaymentSheet usando uma forma de pagamento externa, ele chama o gerenciador com o tipo (por exemplo, “external_fawry”), todos os dados de cobrança que foram coletados e um gerenciador de conclusão.

Sua implementação conclui o pagamento (por exemplo, usando o SDK do provedor de forma de pagamento externo) e chama o gerenciador de conclusão com o resultado do pagamento: completed, canceled ou failure(error:).

Se você passar .failure(error:), PaymentSheet exibe o erro usando errorDescription para erros Swift e localizedDescription para NSErrors.

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
    func setUpPaymentSheet() {
        // ...
        var configuration = PaymentSheet.Configuration()
        configuration.externalPaymentMethods = .init(
            externalPaymentMethods: ["external_fawry"]
        ) { [weak self] externalPaymentMethodType, billingDetails, completion in
            self?.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
        }
        // ...
    }

    func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
        // Your implementation should complete the payment with the payment method provider
        // When the payment completes, cancels, or fails, call the `completion` handler
        // Note you can present on top of PaymentSheet by using the `self.presentedViewController`.
        // This example code just immediately fails:
        let exampleError = NSError(domain: "MyErrorDomain", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to complete payment!"])
        completion(.failed(error: exampleError))
    }
}

OpcionalPosicionar formas de pagamento externas

Teste a integração

Percorra o fluxo de checkout e verifique se o Payment Element exibe Fawry. Este exemplo configura Fawry na segunda posição depois das cartas.
Escolha a forma de pagamento Fawry.
Clique em Pagar agora para testar sua integração Fawry existente. Verifique se sua integração conclui a transação e se todas as ações pós-pagamento (por exemplo, exibe uma página de confirmação, mensagem de êxito ou mensagem de falha) ainda funcionam com sua integração Fawry.

Considerações sobre o Dashboard

PaymentIntents para transações processadas com um provedor de forma de pagamento externo têm um status incomplete no Stripe Dashboard. A Stripe não está envolvida em transações de forma de pagamento externa e não pode determinar o status dessas transações.

Se você coletar dados de pagamento antes de criar um Intent, não verá nenhuma transação incomplete no Stripe Dashboard para transações que foram processadas com um provedor de forma de pagamento externo.

Declaração de isenção de responsabilidade sobre formas de pagamento externas

Você pode usar o Payment Element para dispositivos móveis da Stripe para mostrar algumas formas de pagamento externas que não são aceitas pela Stripe, mas que você integra diretamente. Quando os clientes escolhem uma forma de pagamento externa, seu aplicativo conclui a transação em vez do Payment Element para dispositivos móveis da Stripe. Você reconhece que:

As formas de pagamento externas não são oferecidas nem aceitas por Stripe. A operação e o suporte de formas de pagamento externas são fornecidos pelo provedor da forma de pagamento externa.
Você é responsável por manter uma integração direta com o provedor da forma de pagamento externo.
Você precisa manter um contrato com o provedor da forma de pagamento externa e é responsável pelo cumprimento dos contratos com cada provedor de forma de pagamento externa.
Você é responsável por obter todos os direitos necessários para usar as marcas e logotipos do provedor da forma de pagamento externa no seu checkout, conforme descrito nesta documentação.
A Stripe não é responsável pelo processamento de nenhuma transação com qualquer provedor de formas de pagamento externas, incluindo, por exemplo, cobranças, reembolsos, disputas, liquidações ou fluxos de fundos.
Você ou o provedor da forma de pagamento externa é responsável pela conclusão do fluxo de compra após o cliente selecionar uma forma de pagamento externa, incluindo, por exemplo, a confirmação do pedido e a reconciliação de pedidos.
Você é responsável por configurar corretamente o URL de redirecionamento para a forma de pagamento externa.
Você precisa remover imediatamente qualquer forma de pagamento externa caso seus contratos com qualquer provedor de formas de pagamento externas sejam rescindidos ou a Stripe remova a disponibilidade de uma forma de pagamento externa.
Você só tem permissão para integrar e apresentar no Payment Element as formas de pagamento externas listadas neste guia.
Você é o único responsável por garantir que os compradores sejam redirecionados corretamente para a forma de pagamento externa escolhida.

Disponibilidade contínua de formas de pagamento externas

A Stripe pode, a qualquer momento, decidir remover a disponibilidade de qualquer forma de pagamento como forma de pagamento externa. A Stripe notificará sobre a remoção de uma forma de pagamento externa que você estiver usando, e você deverá remover imediatamente a forma de pagamento externa do seu código. Se isso não for feito, a forma de pagamento externa não será exibida aos clientes.

Formas de pagamento externas disponíveis

Você pode exibir as seguintes formas de pagamento externas. Você precisa usar o tipo de forma de pagamento externo correspondente no seu código.

Região	Forma de pagamento	Tipo de forma de pagamento externa

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (Softbank carrier payments)	`external_softbank_carrier_payment`
APAC	Toss Pay	`external_toss_pay`
APAC	Laybuy	`external_laybuy`
APAC	Bank Pay	`external_bank_pay`
APAC	auかんたん決済 (au easy payments)	`external_au_easy_payment`
APAC	BitCash	`external_bitcash`
APAC	Azupay	`external_azupay`
APAC	d払い (d-barai)	`external_dbarai`
APAC	FamiPay	`external_famipay`
APAC	GCash	`external_gcash`
APAC	GrabPay Later	`external_grabpay_later`
APAC	MoMo	`external_momo`
APAC	NET CASH	`external_net_cash`
APAC	Octopus	`external_octopus`
APAC	Paidy	`external_paidy`
APAC	PayPay	`external_paypay`
APAC	PlanPay	`external_planpay`
APAC	ペイジー (Pay-easy)	`external_pay_easy`
APAC	楽天ペイ (Rakuten Pay)	`external_rakuten_pay`
APAC	メルペイ (Merpay)	`external_merpay`
APAC	WebMoney	`external_webmoney`
Ásia-Pacífico, Europa	Shopback Pay	`external_shopback_pay`
Europa	Aplazame	`external_aplazame`
Europa	Bizum	`external_bizum`
Europa	Divido	`external_divido`
Europa	Fonix	`external_fonix`
Europa	Iwocapay	`external_iwocapay`
Europa	KBC	`external_kbc`
Europa	Nexi Pay	`external_nexi_pay`
Europa	Oney	`external_oney`
Europa	Payconiq	`external_payconiq`
Europa	PayPo	`external_paypo`
Europa	Sofinco	`external_sofinco`
Europa	Postepay	`external_postepay`
Europa	PostFinance	`external_postfinance`
Europa	Scalapay	`external_scalapay`
Europa	TrueLayer	`external_truelayer`
Europa	Walley	`external_walley`
Europa	YounitedPay	`external_younited_pay`
Global	LINE Pay	`external_line_pay`
Global	paysafecard	`external_paysafecard`
Global	Samsung Pay	`external_samsung_pay`
Global	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`