stone-payments / android-uri-demo Goto Github PK

O app linking só funciona quando a app mPOS já está aberta e pareada com o pinpad, caso contrário, a chamada a stone://payment?<parametros> só "pisca", como se fosse abrir a app, mas não abre de fato.
Os parâmetros enviados em nossa chamada são:

• acquirerProtocol
• action
• acquirerId
• installmentType
• installments
• paymentType
• amount
• installmentsInterestRate
• scheme
• autoConfirm
• paymentId
• paymentSystem
• paymentSystemName
• paymentGroupName
• transactionId
• value

Precisamos que o retorno do fluxo de pagamento do mPOS seja para instore://payment/?<parametros_de_resposta>, sendo os parâmetros de resposta:

• scheme: "instore"
• action: "payment"
• paymentId: string (o mesmo enviado na ação de ida)
• acquirerTid: string (e.g. "<stone_itk>")
• acquirerAuthorizationCode: string (e.g. "<stone_atk>")
• merchantReceipt: string (recibo do estabelecimento)
• customerReceipt: string (recibo do cliente)
• responsecode: int (0 significa sucesso e qualquer número maior que 0 significa um código de erro do adquirente e nesse caso reason será uma mensagem de erro)
• reason: string (em caso de sucesso fica vazio e em caso de erro contém a mensagem de erro)

Parâmetros de ida do pagamento:

• acquirerId: string (e.g. "<stone_code>") // <- iremos incluir nas chamadas
• installments: int (e.g. 3 parcelas) // ok
• paymentType: string (e.g. "credit" or "debit") // ok
• amount: long (e.g. 1034) // ok
• transactionId: string (e.g.: "1093019039") // ok
• paymentId: string (e.g.: "1093019888") // <- Adicionar
• scheme: string // <- mudar o nome

ex.: stone-payment://payment/?parametrosIda&scheme=instore // <- mudar o host de como faz esse link

Retorno:
ex.: instore://payment/?parametrosVolta // <- mudar o host de como faz esse link

• paymentId: string (e.g.: "1093019888") // <- salvar e retornar o mesmo
• acquirerTid: string (e.g. "<stone_itk>")
• acquirerAuthorizationCode: string (e.g. "<stone_atk>")
• customerReceipt: string (returned by the app) // <- incluido em outra issue
• merchantReceipt: string (returned by the app) // <- incluido em outra issue
• responsecode (0 = ok, !0 -> reason = <error_msg>) // <- mudar o nome
• reason: string // <- mudar o nome

Recibo do cliente e do estabelecimento em 2 parâmetros: customerReceipt e merchantReceipt
Tanto para pagamento quanto para estorno

lorem ipsum

Feedback visual muito discreto de que retornou com sucesso (aumentar o tempo do toast ou criar um alerta com botão de confirmação).

E no pinpad fica escrito: "TRANSAC APROVADA" eternamente se a transação foi feita por esse applinking.

Acredito que poderia antes de retornar da mPos, voltar ao padrão de ficar escrito: STONE PAGAMENTOS, que é o texto que fica se vc faz direto via mPos, sem applinking.

Ida do estorno (payment-reversal):
ex.: Cappta://payment-reversal/?parametrosIda&scheme=instore // <- mudar o nome da action

• paymentId: string (e.g.: "1093019888")
• scheme: string (e.g.: instore)

Retorno:
ex.: instore://payment-reversal/?parametrosVolta // <- retornar com o mesmo nome

• customerReceipt: string (returned by the app) // <- já pedido em outra issue
• merchantReceipt: string (returned by the app) // <- já pedido em outra issue
• responsecode (0 = ok, !0 -> reason = <error_msg>)
• reason: string

Só funciona o applinking quando a app da mPos está aberta e eu pareio com a maquinha e deixo ela aberta. Ou seja, se eu nunca a abri a app da mPos dá erro de pareamento, mesmo se antes eu tenha pareado via bluetooth com a maquininha.

Pra testar: basta fazer o fluxo com a app da mPos aberta e depois matar o seu processo, o applinking até abre a app da mPos novamente, mas dá erro de pareamento (deveria tentar reconectar com a maquininha atualmente ligada no bluetooth ou a última que já tenha pareado).

No primeiro momento de configuração do inStore, a app da stone receberá:
ex.: stone-payment://configuration/?acquirerId=<stone_code>&scheme=instore

E tem que garantir que a app fique configurada e pareada com o pinpad e então retornar:
ex.: instore://configuration/?responsecode=&reason=<error_msg>
responsecode (0 = ok, !0 -> reason = <error_msg>) + reason: string

O applinking deve por padrão pedir pra mPos para já efetuar a transação com cartão no pinpad sem precisar de nenhuma ação do usuário.
Se a app de origem quiser editar a transação antes de enviar (uma confirmação), pode ser uma opção extra do applinking.
Atualmente o applinking precisa de confirmação e não permite editar nenhum dado da transação original.