Etapa 3: Criar um formToken

Objetivo

Gerar um formToken.

O formToken é uma chave gerada pela plataforma. Define o contexto de pagamento (valor, moeda, número de pedido, dados do comprador, etc.).

O formToken é o resultado da resposta à chamada do Web Service REST Charge/CreatePayment. Válido durante 15 minutos.

I. Solicitação para um pagamento simples

Exemplo: .

valor: 9,90€.
Pedidos: "myOrderId-999999",
e-mail do comprador: "sample@example.com ".

/pt-BR/rest/V4.0/api/kb/authentication.html

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44

https://api.lyra.com/api-payment/V4/Charge/CreatePayment

{
    "amount":   990,
    "currency": "EUR",
    "orderId":  "myOrderId-999999",
    "customer": {
        "email": "sample@example.com"
    }
}

{
    "amount":   1500,
    "currency": "PEN",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}

{
    "amount":   20000,
    "currency": "ARS",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}

{
    "amount":   100000,
    "currency": "COP",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}

{
    "amount":   2500,
    "currency": "BRL",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}

II. Resposta para um pagamento simples

{
    "status": "SUCCESS",
    "_type": "V4/WebService/Response",
    "webService": "Charge/CreatePayment",
    "applicationProvider": "LYRA",
    "version": "V4",
    "applicationVersion": "4.1.0",
    "answer": {
        "formToken": "DEMO-TOKEN-TO-BE-REPLACED",
        "_type": "V4/Charge/PaymentForm"
    }
}

III. Outros caso de uso

Outros exemplos estão disponíveis nesta página: Caso de uso.

IV. Utilização do Playground

Use o playground Charge/CreatePayment para ver todos os campos disponíveis.

Clique no botão "Fazer um teste", crie sua solicitação e execute a chamada REST para gerar o formToken.

V. Exemplo simplificado PHP

Na pasta sample, o arquivo para essa etapa é formToken.php.

Para maiores detalhes, Arquivo de exemplo: formToken.php

Categoria

Tags