Ticket

A loja tem a possibilidade de configurar o roteamento de transações feitas com cartões da crédito e débito no Carat por vários meios de pagamento, um desses meios é o Ticket REST. Esta é a plataforma e-commerce da adquirente Ticket. No caso da ticket as transações serão feitas apenas por débito utilizando Alimentação, Refeição, Flex e Super Flex.

ATENÇÃO: É necessário solicitar ao suporte para cadastrar o CNPJ da loja vinculada com a Ticket, caso já não esteja registrado.

Será usada a nomenclatura "Ticket REST" para referenciar o roteamento no Carat.

Interfaces Carat suportadas para integração

É possível utilizar as seguintes interfaces para a integração com o roteamento Ticket REST:

• Pagamento REST
• Cancelamento REST
• Pagamento HTML
• Cancelamento no Portal do Lojista

Fluxos

Nesta seção serão apresentadas as particularidades do fluxo transacional Ticket REST.

Atualmente, o Ticket REST não permite parcelamento, ou seja, o campo installments_type deve receber o valor 4. O campo installments deve receber o valor de 1 parcela.

Criação de Transação de Pagamento (REST)

Exemplo de requisição de criação de transação para Pagamento REST:

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor<br/> <URLPOSTMAN/>

curl
--request POST "https://{{url}}/e-sitef/api/v1/transactions"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "merchant_usn":"123456789",
	"order_id":"pedido001",
	"amount":"30",
	"authorizer_id":"70",
	"installments":"1",
	"installment_type":"4"
}
--verbose

Resposta

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "payment": {
        "status": "NOV",
        "nit": "bc930a37f74fc71330096efd7d2d41eca5a0611b62f8a16125c21cbc1177f083",
        "order_id": "14111112826",
        "merchant_usn": "14111112826",
        "amount": "30"
    }
}
--verbose

Pagamento REST

Campos relevantes na etapa de efetivação do pagamento:

Exemplo de requisição de efetivação de transação para Pagamento REST:

ATENÇÃO: o campo de data de validade do cartão (card.expiry_date) não é obrigatório para a efetivação do pagamento.

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor<br/> <URLPOSTMAN/>

curl
--request POST "https://{{url}}/e-sitef/api/v1/payments/2ccd49b410268c8332ef9e4aeb9d1e481a662944814ce24226bc3502b04013f9"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "card": {
        "number": "6026514493311762",
        "security_code": "669"
    }
}
--verbose

Resposta

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "payment": {
        "authorizer_code": "00",
        "authorizer_message": "APPROVED",
        "status": "CON",
        "nit": "bc930a37f74fc71330096efd7d2d41eca5a0611b62f8a16125c21cbc1177f083",
        "order_id": "14111112826",
        "customer_receipt": " DEBITO \n \n ESTAB: TICKETREST \n DATA: 19/09/2022 HORA: 17:19:10 \n CODIGO PEDIDO: 14111112826 \n \n ID TRANSACAO: \n 429d9e3b-e190-4e16-9efe-e2a98c8650cd \n \n AUTORIZACAO: 306034 \n VALOR: 0,30 \n \n (e-SiTef) \n \n1a VIA - CLIENTE \n \n",
        "merchant_receipt": " DEBITO \n \n ESTAB: TICKETREST \n DATA: 19/09/2022 HORA: 17:19:10 \n CODIGO PEDIDO: 14111112826 \n \n ID TRANSACAO: \n 429d9e3b-e190-4e16-9efe-e2a98c8650cd \n \n AUTORIZACAO: 306034 \n VALOR: 0,30 \n NSU e-SiTef: 220919108106350 \n \n (e-SiTef) \n \n2a VIA - ESTABELECIMENTO \n \n",
        "authorizer_id": "70",
        "acquirer_id": "417",
        "acquirer_name": "TicketRest",
        "authorizer_date": "19/09/2022T17:18",
        "authorization_number": "306034",
        "merchant_usn": "14111112826",
        "esitef_usn": "220919108106350",
        "host_usn": "1",
        "tid": "429d9e3b-e190-4e16-9efe-e2a98c8650cd",
        "amount": "30",
        "payment_type": "D",
        "balance": "9.9998914131E8",
        "payment_date": "19/09/2022T17:19"
    }
}
--verbose

Cancelamento

O Cancelamento de uma transação pode ser feito via Web Service REST e através do Portal do Lojista.

As solicitações de cancelamento podem ser realizadas em até 180 dias, somente no valor total da transação original de pagamento.

ATENÇÃO: o campo de data de validade do cartão (card.expiry_date) não é obrigatório para a efetivação do cancelamento.

Exemplo de requisição de criação de transação para Cancelamento REST:

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor<br/> <URLPOSTMAN/>

curl
--request POST "https://{{url}}/e-sitef/api/v1/cancellations/"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "esitef_usn":"190129022924690"
}
--verbose

Resposta

{
    "code": "0",
    "message": "OK. Transaction successful."
}
--verbose

Exemplo de requisição de efetivação de transação para Cancelamento REST:

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor<br/> <URLPOSTMAN/>

curl
--request PUT "https://{{url}}/e-sitef/api/v1/cancellations/2ccd49b410268c8332ef9e4aeb9d1e481a662944814ce24226bc3502b04013f9"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "card": {
        "number": "6026514493311762"
    },
    "amount": "30"
}
--verbose

Resposta

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "cancellation": {
        "authorizer_code": "00",
        "authorizer_message": "APPROVED",
        "status": "CON",
        "nit": "e98c3cef86b22baae112223eee1cf5f2a8d82d4e3b38f633f07d9b34ecde8544",
        "order_id": "14111112826",
        "customer_receipt": " CANCELAMENTO DE VENDA \n1a VIA - CLIENTE \nDATA: 19/09/2022 HORA: 18:41:49 \nAUTORIZ. DA TRN. DE PGTO.: 73f5356c-2ea3-4e31-bdcc-c8f6326b6a24\n \nVALOR TOTAL DO CANCELAMENTO: 0,30 \n \nSOLICITACAO DE CANCELAMENTO REGISTRADA. \n \n (e-SiTef) \n",
        "merchant_receipt": " CANCELAMENTO DE VENDA \n2a VIA - ESTABELECIMENTO \nDATA: 19/09/2022 HORA: 18:41:49 \nAUTORIZ. DA TRN. DE PGTO.: 73f5356c-2ea3-4e31-bdcc-c8f6326b6a24\n \nVALOR TOTAL DO CANCELAMENTO: 0,30 \n \nSOLICITACAO DE CANCELAMENTO REGISTRADA. \n \n (e-SiTef) \n",
        "authorizer_id": "70",
        "acquirer_id": "417",
        "acquirer_name": "TicketRest",
        "authorizer_date": "19/09/2022T18:39",
        "authorization_number": "306053",
        "merchant_usn": "14111112826",
        "esitef_usn": "220919108107251",
        "host_usn": "37",
        "tid": "9dff3440-6488-4872-9660-04779d81c3da",
        "amount": "30",
        "payment_type": "D",
        "esitef_date": "19/09/2022T18:41",
        "is_host_cancel": "false"
    }
}
--verbose