Confirm a payment initiation.
The initiation need to be in the status requires_confirmation
and need to be send in the request body the return_url
.
Todos os campos são obrigatórios para realizar a confirmação. Qualquer campo faltante em uma iniciação já criada pode ser atualizado na chamada da confirmação.
E lembre-se que você também pode usar a API de criação comconfirm=true
se você preferir criar e confirmar na mesma chamada.
Após a confirmação, em caso de erro no processamento, que ocorre de forma assíncrona, a iniciação terá o status
failed
e o campoerror
que possui o seguinte formato:"status": "failed", "error": { "code": "failed", "message": "An error has occurred." }
URL de retorno
Ao confirmar uma iniciação, é necessário enviar o parâmetro return_url
, que corresponde à URL que o usuário será redirecionado ao final do seu processo no aplicativo da instituição.
O formato final da URL que o usuário será redirecionado é:
<return_url>/<payment_initiation_id>/<internal_id>/<state>
Por exemplo, caso o parâmetro return_url
informado tenha sido: "https://seuapp.com"
, então o usuário será redirecionado para:
https://seuapp.com/b45bb11a-31d6-4d3f-9701-38ef4db5b15e/a6518418-644d-4d83-95a3-27dccacb2abb/AUTHORISED
internal_id
é apenas um identificador interno que faz parte da URL de redirecionamento e não precisa ser utilizado.
state poderá serAUTHORISED
ouCONSENT_REJECT
O ambiente de sandbox está sujeito à limitações quanto a integração com outros ambientes de teste do arranjo Open Banking e, portanto, pode apresentar instabilidade.
Entre em contato conosco caso esteja com problemas ao testar o fluxo completo.