Listar recebimentos
Lista os recebimentos do parceiro, por solicitação de crédito. Limite: 10 requisições por segundo por IP; acima disso a resposta é 429. Datas no formato `AAAA-MM-DD`. Os filtros `status`, `productType`, `courseId`, `delayedDay`, `delayedInstallment` e `campaign` podem ser repetidos. Veja os valores aceitos em **Listar filtros de recebimentos**.
Autorização
apiToken Token do parceiro. Gere no painel do parceiro: Configurações > Integrações > API Token (perfil Admin ou Superadmin). Envie só este header: se Authorization também for enviado, ele tem prioridade e a requisição é recusada com 401.
Local: header
Parâmetros de Query
Página (começa em 1).
Itens por página.
ID da venda.
CPF do aluno.
E-mail do aluno.
Nome do aluno.
Situação.
Tipo de produto.
ID do curso.
Dias de atraso.
Parcelas em atraso.
Nome da campanha.
Identificador próprio da campanha.
Efetivação, data inicial.
Efetivação, data final.
Liberação do curso, data inicial.
Liberação do curso, data final.
Próximo pagamento, data inicial.
Próximo pagamento, data final.
Acordo, data inicial.
Acordo, data final.
Repasse previsto, data inicial.
Repasse previsto, data final.
Repasse realizado, data inicial.
Repasse realizado, data final.
Só vendas com chargeback. Qualquer valor liga o filtro (inclusive false); para desligar, omita o parâmetro.
Só vendas com cancelamento. Qualquer valor liga o filtro (inclusive false); para desligar, omita o parâmetro.
Corpo da Resposta
application/json
application/json
application/json
curl -X GET "https://example.com/receipts?page=2&limit=1"{ "paging": { "itemsPerPage": 1, "nextPage": 3, "currentPage": 2, "previousPage": 1, "totalPages": 10, "totalItems": 10 }, "content": [ { "crid": 123, "campaignName": null, "redirectUrl": "https://pay.provi.com.br/business_slug", "email": "123@123.com", "productType": "CourseFinancing", "name": "Student name", "phone": "11912341234", "status": "effective", "hostingStatus": "host_not_connected", "nextPaymentDate": null, "courseReleasedAt": null, "courses": [ { "id": 123, "name": "Course name", "isFullTime": false, "modality": "remoto", "price": 117480 } ], "saleValue": 117480, "cpf": "12312312312", "madeEffectiveDate": "2021-11-06", "commission": { "value": 18797, "percentage": 16 }, "receivedValue": 98683, "missingValue": 0, "transferDate": "2021-12-09", "installmentCount": { "current": { "upfront": 1, "installments": 12 }, "paid": 2, "late": null }, "lateDays": null, "agreementDate": null, "installmentValue": 9305, "address": { "street": "Rua do aluno", "number": "1", "complement": "complmento como casa ou apartamento", "district": "Bairo", "cep": "12312312", "city": "São Paulo", "state": "SP" }, "pfCount": 1, "nextPaymentInstallmentId": 6226438, "expectedTransferDate": "2021-12-10", "showFullPlatformDetails": false, "showPlatformDetails": false, "comment": null, "expectedTedValue": 98683, "originalInstallmentsValue": null, "originalNumberOfInstallments": null, "isRenegotiated": false } ]}Ativar ou inativar campanha
Ativa ou inativa uma campanha, e permite trocar o `customIdentifier`. Envie só os campos que quer mudar. Ao inativar uma campanha com data de fim, a data de fim passa a ser o momento atual; ao reativá-la, a data de fim é removida. A resposta de sucesso é 204, sem corpo.
Listar filtros de recebimentos
Lista os filtros e valores aceitos na listagem de recebimentos.