Checkout
Status de pedidos
Includes disponíveis: emailDetails
Listar status
GET https://api.dooki.com.br/v2/{alias}/checkout/statuses
Filtros personalizados
Parâmetro | Tipo | Descrição |
orderId | int | Retorna os status esperado por um pedido. |
Response de status
Todos os status disponíveis
Alias | Nome | Descrição |
| Pedido realizado | O pedido foi realizado. |
| Pedido autorizado | O pedido foi autorizado e está aguardando captura. |
| Aguardando confirmação de pagamento | O pedido ainda não foi pago. |
| Pagamento aprovado | O pedido foi pago/capturado. |
| Produtos em separação | Os produtos estão em separação, aguardando postagem. |
| Em transporte | O pedido já foi postado para a transportadora. |
| Entregue | O pedido foi entregue ao destinatário. |
| Pedido cancelado | O pedido foi cancelado. |
| Pagamento não aprovado | O pagamento não foi aprovado. |
| Faturado | O pedido foi faturado. |
| Exceção na entrega | O pedido teve um problema em sua entrega. |
Request para alterar o assunto e mensagem do e-mail de um status
Atualizar detalhes do e-mail de um status
PUT https://api.dooki.com.br/v2/{alias}/checkout/statuses/{id}/email-details
Bancos
Listar bancos
GET https://api.dooki.com.br/v2/{alias}/checkout/banks
Response de bancos
Visualizar banco
GET https://api.dooki.com.br/v2/{alias}/checkout/banks/{id}
Gateways de pagamento
Includes disponíveis: form
Listar gateways de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways
Response de gateways de pagamento
Visualizar gateway de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways/{alias}
Visualizar parâmetros de um gateway de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways/{alias}/params
Afiliações
Listar afiliações
GET https://api.dooki.com.br/v2/{alias}/checkout/affiliations
Request
Response
Criar afiliação
POST https://api.dooki.com.br/v2/{alias}/checkout/affiliations
Parâmetro | Tipo | Obrigatório | Descrição |
gateway_alias | string | Sim | Alias do gateway de pagamento. |
name | string | Sim | Nome da afiliação. |
params | array | Sim | Parâmetros da afiliação. |
Visualizar afiliação
GET https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
Atualizar afiliação
PUT https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
Excluir afiliação
DELETE https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
Formas de pagamentos
Listar formas de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/payments
Response
Visualizar forma de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}
Configurações de pagamentos
Listar configurações
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/config
Request
Response
Criar configuração de pagamento
POST https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config
Parâmetro | Tipo | Obrigatório | Descrição |
payment_id | int | Sim | ID do pagamento. |
affiliation_id | int | Sim | ID da afiliação. |
active | boolean | Sim | Status da configuração. |
default_display | boolean | Sim | Marca se essa configuração será a padrão para exibição na vitrine. |
accumulate_discount | boolean | Não | Marca se o desconto irá acumular com outros descontos. |
ignore_promotions | boolean | Não | Marca se o desconto excluirá produtos já em promoção |
percent_discount | float | Não | Porcentagem de desconto. |
min_installment_value | float | Não | Valor mínimo da parcela. |
max_installments_without_tax | int | Não | Máximo de parcelas sem juros. |
billet_expire_days | int | Não | Número de dias de vencimento do boleto. |
Visualizar configuração de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
Atualizar configuração de pagamento
PUT https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
Excluir configuração de pagamento
DELETE https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
Parcelamento
Listar parcelamentos de um pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/installments
Request
Response
Criar regras de parcelamentos para um pagamento
POST https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/installments
Parâmetro | Tipo | Obrigatório | Descrição |
payment_id | int | Sim | ID do pagamento. |
installment | int | Sim | Número da parcela. |
tax | float | Sim | Taxa de juros para a parcela. |
percent_discount | float | Sim | Porcentagem de desconto para a parcela. |
Simular parcelamento de um pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/installments/simulate
Parâmetro | Tipo | Obrigatório | Descrição |
amount | float | Sim | Valor simulado. |
min_installment_value | float | Sim | Valor mínimo da parcela. |
max_installments_without_tax | int | Sim | Máximo de parcelas sem juros. |
currency | string | Não | Moeda. |
taxes[0][tax] | array | Sim | Taxa de juros da parcela (em porcentagem). |
taxes[0][installment] | array | Sim | Número da parcela. |
taxes[0][percent_discount] | array | Sim | Desconto (em porcentagem) da parcela. |
Response da simulação de parcelamento
Carrinhos abandonados
Includes disponíveis: customer, payment, address, promocode, items, seller
Listar carrinhos abandonados
Limite de 100 carrinhos por página usando o parâmetro limit
.
A API retornará no máximo 10.000 itens na listagem.
GET https://api.dooki.com.br/v2/{alias}/checkout/carts
Response
Filtros personalizados
Esse tipo de filtro não utiliza a sintaxe global. Neste caso, o parâmetro é passado individualmente via query string na URL.
Parâmetro | Tipo | Descrição |
q | string | Termo de busca. A API buscará carrinhos pelo nome, e-mail e telefone do cliente. |
utm_source | array | Lista de acordo com a lista de utm_source |
utm_campaign | array | Lista de acordo com a lista de utm_campaign |
status | string | Lista os carrinhos de acordo com o status de pagamento. Valores aceitos: |
date | string | Range de datas. Exemplo: |
Exportar carrinhos abandonados
GET https://api.dooki.com.br/v2/{alias}/checkout/carts/export
Dica: os filtros de busca também estão disponíveis no endpoint de exportação.
O sistema enviará para o usuário um e-mail com o link para download da planilha com os registros.
Estatísticas de carrinhos abandonados
GET https://api.dooki.com.br/v2/{alias}/checkout/carts/stats
Transações de carrinhos abandonados
GET https://api.dooki.com.br/v2/{alias}/checkout/carts/{id}/transactions
Response de estatísticas de carrinhos abandonados
Configurações
Buscar configurações de carrinhos abandonados
GET https://api.dooki.com.br/v2/{alias}/config/carts/{id}
Response
Atualizar Configurações
PUT https://api.dooki.com.br/v2/{alias}/config/carts/{id}
Request
| Tipo | Obrigatório | Descrição |
active | boolean | Sim | Ativa/Inativa o envio de email de recuperação de carrinho abandonado |
messages | array | Sim | E-mails que serão enviados para o cliente |
messages.*.active | boolean | Sim | Se esse e-mail em específico será enviado |
messages.*.email_subject | string | Sim | Assunto do e-mail para carrinhos com apenas 1 produto |
messages.*email_subject_multiple | string | Sim | Assunto do e-mail para carrinhos com mais de 1 produto |
messages.*.email_message | string | Sim | Conteúdo do e-mail para carrinhos com apenas 1 produto |
messages.*.email_message_multiple | string | Sim | Conteúdo do em-mail para carrinhos com mais de 1 produto |
messages.*.hours_delay | numeric | Sim | Intervalo de tempo (em horas) em que o e-mail será disparado |
messages.*.sms_message | string | Não | Conteúdo do SMS para carrinhos com apenas 1 produto |
messages.*.sms_message_multiple | string | Não | Conteúdo do SMS para carrinhos com mais de 1 produto |
Response
Resetar configurações
PUT https://api.dooki.com.br/v2/{alias}/config/carts/{id}/reset
Transações
Includes disponíveis: affiliation, payment, customer, requestData, logs
Transações são criadas para toda tentativa de pagamento. Um pedido pode ter uma ou mais transações (no caso de pagamento com mais de um cartão).
Listar transações
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions
Response de transações
Confirmar uma transação de boleto ou depósito
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/confirm
Cancelar uma transação de boleto ou depósito
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/cancel
Capturar uma transação de cartão de crédito
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/gateway/capture
Cancelar uma transação de cartão de crédito
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/gateway/cancel
Status de transações
Status | Descrição |
paid | A transação foi paga. |
cancelled | A transação foi cancelada. |
chargeback | A transação sofreu chargeback. |
created | A transação foi criada. |
refused | A transação foi negada. |
waiting_payment | A transação está aguardando pagamento. |
Visualizar transação
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}
Listar logs de uma transação
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/logs
Response de logs de transação
Vendedores
Includes disponíveis: bankAccounts
Listar vendedores
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers
Visualizar vendedor
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
Criar vendedor
POST https://api.dooki.com.br/v2/{alias}/checkout/sellers
Request
Response
Parâmetro | Tipo | Obrigatório | Descrição |
affiliation_id | int/nullable | Não | ID da afiliação. |
bank_account_id | int/nullable | Não | ID da conta bancária. |
has_split | boolean | Não | Split de pagamentos habilitado (default: false). |
transfer_enabled | boolean | Sim | Indica se haverá transferência automática |
active | boolean | Não | Status do vendedor (default: true). |
name | string | Sim | Nome do vendedor. |
Sim | Email do vendedor. | ||
document | string | Sim | Documento do vendedor. |
document_type | string | Sim | Tipo de documento do vendedor (valores aceitos: cpf, cnpj). |
transfer_interval | string | Sim | Intervalo de transferência (valores aceitos: daily, weekly, monthly). |
transfer_day | int | Sim | Dia em que será realizada a transferência (valores aceitos: entre 0 e 31). |
antecipatable_volume_percentage | int | Não | Porcentagem referente ao valor a receber que o vendedor pode antecipar (defaul: 0). |
automatic_anticipation_enabled | boolean | Não | Define se o vendedor pode receber antecipações automáticas (default: false). |
ref_code | string | Sim | Código de referência do vendedor. |
external_gateway_id | string | Não | ID do recebedor no pagarme. |
percentage_products | int | Sim | Porcentagem de comissão em cima dos produtos. |
percentage_shipping | int | Sim | Porcentagem de comissão em cima do frete. |
charge_processing_fee | boolean | Não | Indica se o vendedor será cobrado pelas taxas da transação (default: false). |
liable | boolean | Sim | indica se o vendedor assumirá os riscos de chargeback da transação. |
Obs : Os valores aceitos pelo parâmentro transfer_day são de acordo com o intervalo de transferência (transfer_interval).
Intervalo de transferência | Valor aceito (transfer_day) |
monthly | 1 a 31 |
weekly | 1 a 5 |
daily | 0 |
Atualizar vendedor
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
Atualização em lote
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/batch-update
Request - atualização em lote
Excluir vendedor
DELETE https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
Contas bancárias
Listar contas bancárias
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts
Visualizar conta bancária
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
Criar conta bancária
POST https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts
Request
Response
Parâmetro | Tipo | Obrigatório | Descrição |
affiliation_id | int/nullable | Não | ID da afiliação. |
bank_code | string | Sim | Código do banco. |
external_gateway_id | int | Sim | ID no pagarme. |
agency | string | Sim | Número da agência bancaria. |
agency_digit | string | Sim | Dígito da agência bancaria. |
account | string | Sim | Número da conta. |
account_digit | string | Sim | Dígito da conta. |
document_number | string | Sim | Número do documento. |
legal_name | string | Sim | Nome ou razão social do titular da conta. |
type | string | Sim | Tipo da conta (valores aceitos: conta_corrente, conta_poupanca, conta_corrente_conjunta, conta_poupanca_conjunta ). |
Atualizar conta bancária
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
Excluir conta bancária
DELETE https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
Last updated