Checkout
Atualizado
Atualizado
Includes disponíveis: emailDetails
GET https://api.dooki.com.br/v2/{alias}/checkout/statuses
Response de status
Request para alterar o assunto e mensagem do e-mail de um status
PUT https://api.dooki.com.br/v2/{alias}/checkout/statuses/{id}/email-details
GET https://api.dooki.com.br/v2/{alias}/checkout/banks
Response de bancos
GET https://api.dooki.com.br/v2/{alias}/checkout/banks/{id}
Includes disponíveis: form
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways
Response de gateways de pagamento
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways/{alias}
GET https://api.dooki.com.br/v2/{alias}/checkout/gateways/{alias}/params
GET https://api.dooki.com.br/v2/{alias}/checkout/affiliations
Request
Response
POST https://api.dooki.com.br/v2/{alias}/checkout/affiliations
GET https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
PUT https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
DELETE https://api.dooki.com.br/v2/{alias}/checkout/affiliations/{id}
GET https://api.dooki.com.br/v2/{alias}/checkout/payments
Response
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/config
Request
Response
POST https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
PUT https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
DELETE https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/config/{id}
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/installments
Request
Response
POST https://api.dooki.com.br/v2/{alias}/checkout/payments/{paymentId}/installments
GET https://api.dooki.com.br/v2/{alias}/checkout/payments/{id}/installments/simulate
Response da simulação de parcelamento
Includes disponíveis: customer, payment, address, promocode, items, seller
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
Esse tipo de filtro não utiliza a sintaxe global. Neste caso, o parâmetro é passado individualmente via query string na URL.
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.
GET https://api.dooki.com.br/v2/{alias}/checkout/carts/stats
GET https://api.dooki.com.br/v2/{alias}/checkout/carts/{id}/transactions
Response de estatísticas de carrinhos abandonados
GET https://api.dooki.com.br/v2/{alias}/config/carts/{id}
Response
PUT https://api.dooki.com.br/v2/{alias}/config/carts/{id}
Request
Response
PUT https://api.dooki.com.br/v2/{alias}/config/carts/{id}/reset
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).
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions
Response de transações
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/confirm
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/cancel
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/gateway/capture
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/payment/gateway/cancel
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}
GET https://api.dooki.com.br/v2/{alias}/checkout/transactions/{id}/logs
Response de logs de transação
Includes disponíveis: bankAccounts
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
POST https://api.dooki.com.br/v2/{alias}/checkout/sellers
Request
Response
Obs : Os valores aceitos pelo parâmentro transfer_day são de acordo com o intervalo de transferência (transfer_interval).
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/batch-update
Request - atualização em lote
DELETE https://api.dooki.com.br/v2/{alias}/checkout/sellers/{id}
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts
GET https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
POST https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts
Request
Response
PUT https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
DELETE https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts/{id}
Parâmetro
Tipo
Descrição
orderId
int
Retorna os status esperado por um pedido.
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.
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.
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.
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.
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.
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`
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
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.
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.
Intervalo de transferência
Valor aceito (transfer_day)
monthly
1 a 31
weekly
1 a 5
daily
0
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 ).