Serviço de criação da transação
O consumo desse serviço é obrigatório no fluxo de pagamento JavaScript. Adicionalmente aos parâmetros de requisição de pagamento REST, também deve ser enviado o seguinte parâmetro:
Parâmetro | Descrição | Formato | Obrigatório |
---|---|---|---|
payment_js | Deve ser enviado com o valor true para habilitar o fluxo de pagamento JavaScript. | < 5 A | SIM |
Como resposta, o seguinte parâmetro será adicionalmente retornado:
Parâmetro | Descrição | Formato |
---|---|---|
payment | ||
pay_token | Token associado ao pagamento JavaScript. | = 66 AN |
Para mais detalhes sobre essa chamada, consulte Pagamento REST.
Exemplo
Requisição:
curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/transactions"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxx"
--data-binary
{
"merchant_usn":"12042142155",
"order_id":"12042142155",
"installments":"1",
"installment_type":"4",
"authorizer_id":"2",
"amount":"1000",
"payment_js":"true"
}
--verbose
Resposta:
{
"code":"0",
"message":"OK. Transaction successful.",
"payment":{
"status":"NOV",
"nit":"1234567890123456789012345678901234567890123456789012345678901234",
"order_id":"12042142155",
"merchant_usn":"12042142155",
"amount":"1000",
"pay_token":"123456789012345678901234567890123456789012345678901234567890123456"
}
}
Pagamento com Armazenamento
Caso se deseje armazenar o cartão utilizado, basta enviar os seguintes campos:
Parâmetro | Descrição | Formato | Obrigatório |
---|---|---|---|
store_card | Deve ser enviado com o valor true para habilitar o fluxo de pagamento com armazenamento JavaScript. | < 5 A | NÃO |
additional_data .payer .store_identification | Identificação do comprador para armazenamento de cartão. Este campo é obrigatório se for passado o campo store_card como true | < 20 N | COND |
Como resposta, o seguinte parâmetro será adicionalmente retornado:
Parâmetro | Descrição | Formato |
---|---|---|
store | ||
nita | Número identificador de transação de armazenamento. | = 65 AN |
Após a efetivação do pagamento, as informações do cartão armazenado serão enviadas para loja através de um Aviso de Armazenamento.
Exemplo
Requisição:
curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/transactions"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxx"
--data-binary
{
"merchant_usn": "571335733160",
"order_id": "1571335733160",
"installments": "1",
"installment_type": "4",
"amount": "1000",
"authorizer_id": "2",
"payment_js": "true",
"store_card": "true",
"additional_data":{
"payer":{
"store_identification":"1222"
}
}
}
--verbose
Resposta:
{
"code": "0",
"message": "OK. Transaction successful.",
"payment": {
"status": "NOV",
"nit": "fa8d9a5b840cca22c467db6aaa22d61561cfcf299f5fba5b033ba43fb7bd35b2",
"order_id": "1571335733160",
"merchant_usn": "571335733160",
"amount": "1000",
"pay_token": "ef3d19cb2c0db0d8c54945da8130b9f47aeb14f3b2f884ef151ecf18d2683d3601"
},
"store": {
"nita": "Z529ebaf6342d0ab680c51c4ec8409bdc0dd43a00bf9956c2f60f7e76f3476419"
}
}