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
created
Pedido realizado
O pedido foi realizado.
authorized
Pedido autorizado
O pedido foi autorizado e está aguardando captura.
waiting_payment
Aguardando confirmação de pagamento
O pedido ainda não foi pago.
paid
Pagamento aprovado
O pedido foi pago/capturado.
handling_products
Produtos em separação
Os produtos estão em separação, aguardando postagem.
on_carriage
Em transporte
O pedido já foi postado para a transportadora.
delivered
Entregue
O pedido foi entregue ao destinatário.
cancelled
Pedido cancelado
O pedido foi cancelado.
refused
Pagamento não aprovado
O pagamento não foi aprovado.
invoiced
Faturado
O pedido foi faturado.
shipment_exception
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: payment_refused
date
string
Range de datas. Exemplo: ?date=created_at:2017-05-21|2017-05-30`
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
Parâmentro
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}
Atualizado