Introdução
Crie o seu primeiro pagamento no sandbox em poucos minutos.
Um único núcleo, duas integrações
Cada pagamento Baraka Pay é um PaymentIntent — o registo canónico de uma obrigação de pagamento. Tanto a API direta como o checkout hospedado pela Baraka Pay acionam o mesmo PaymentIntent, para que a sua contabilidade nunca divirja.
Inicie sessão no portal do Developer para criar uma chave de API sandbox e, em seguida, crie o seu primeiro intent.
Criar um PaymentIntent
Envie um valor em unidades menores (minor units), uma referência do comerciante e um paymentType — o indicador de encaminhamento que seleciona diretamente o adaptador do fornecedor (ver Escolher um tipo de pagamento abaixo). As escritas repetidas devem incluir uma Idempotency-Key.
Confirme e aguarde a verdade
Confirme o intent; a Baraka Pay devolve uma próxima ação neutra em relação ao fornecedor. Alguns tipos de pagamento (as marcas de mobile money) precisam do msisdn do pagador na confirmação — ver Escolher um tipo de pagamento. Trate o webhook assinado (ou uma consulta do lado do servidor) como o único sinal autoritativo de sucesso.
Escolher um tipo de pagamento
paymentType é um catálogo plano: card, eft, qr, mpesa, airtel_money, orange_money, tigo_money, mtn_momo, apple_pay, google_pay, samsung_pay. Seleciona o fornecedor diretamente — a família (por exemplo, "wallet" para as marcas de mobile money e as carteiras de dispositivo) é apenas um agrupamento de exibição, nunca um encaminhamento.
msisdn só é obrigatório na confirmação para os tipos de pagamento de instrumento msisdn (as marcas de mobile money); os outros tipos confirmam sem ele e conduzem o resto através da próxima ação devolvida.
O checkout hospedado atribui o paymentType chamando select-method com a escolha do pagador antes de confirm; os autores de chamadas da API direta definem-no, em vez disso, em create.