Serviço de criação da transação
Detalhes da chamada
- Recurso:
/v1/store
- Método HTTP:
POST
- Formato da requisição:
JSON
- Formato da resposta:
JSON
- Headers:
- Content-Type: application/json
- merchant_id: {seu código de loja}
- merchant_key: {sua chave da loja}
O consumo desse serviço é obrigatório no fluxo de armazenamento JavaScript.
Parâmetros de requisição
Os seguintes parâmetros de requisição devem ser enviados:
Parâmetro | Descrição | Formato | Obrigatório |
---|---|---|---|
merchant_usn | Número sequencial único para cada pedido, criado pela loja. | < 12 N | SIM |
customer_id | Identificação do comprador para armazenamento de cartão. Esta identificação deve ser única para cada usuário da loja. Mas atenção, essa garantia de unicidade é de total responsabilidade da loja, o e-SiTef não realizará nenhuma validação. | < 20 AN | SIM |
Parâmetros de resposta
Na tabela abaixo está a descrição dos parâmetros de resposta:
Parâmetro | Descrição | Formato |
---|---|---|
code | Código de resposta do e-SiTef. Qualquer código diferente de 0 (zero) significa falha. Saiba mais. | < 4 N |
message | Mensagem de resposta do e-SiTef. | < 500 AN |
store | ||
status | Status da transação de armazenamento no e-SiTef. Saiba mais. | = 3 AN |
nsua | Número sequencial único da transação de armazenamento no e-SiTef. | = 15 AN |
nita | Número identificador criptografado da transação de armazenamento devolvido à loja pelo e-SiTef. | < 65 AN |
merchant_usn | Número sequencial único enviado pela loja. | < 12 N |
customer_id | Identificação do comprador para armazenamento de cartão. | < 20 AN |
store_token | Token associado ao armazenamento JavaScript. | = 66 AN |
Exemplo
Requisição:
curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/store"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
"merchant_usn":"16013439434",
"customer_id":"11122211122"
}
--verbose
Resposta:
{
"code":"0",
"message":"OK. Transaction successful.",
"store":{
"status":"CON",
"nsua":"12345600000560A",
"merchant_usn":"16013439434",
"customer_id":"11122211122",
"nita":"Z123adsfrh342r72498r34920ur23r328r2038r023rh0h203rh032r082380rf43",
"store_token": "123456789012345678901234567890123456789012345678901234567890123456"
}
}