Cartão de Crédito
Saiba mais sobre o gerenciamento de ordens de pagamento processadas pela Preme Pay.
Para efetuar uma cobrança via Cartão de Crédito ou Boleto Bancário, você deve criar uma ordem de pagamento. Nesta seção você encontrará informações detalhadas relacionadas ao método de pagamento com cartão.
Você pode recuperar e estornar cobranças individuais seguindo os paramentros apresentados em Reembolso. Você também pode listar todas as ordem de pagamento, visualizar os detalhes ou excluir uma ordem de pagamento de acordo com as especificações apresentadas.

Adicionar Ordem de Pagamento

https://api.premepay.com/v1/stores/{storeId}/orders
Utilizando a rota acima você pode adicionar uma ordem de pagamento com Cartão de Crédito.
Parâmetro
Tipo
Descrição
Obrigatório
customerId
integer
Identificador do consumidor
Sim
fingerprint
string
Identificador único da sessão do usuário
Não
includeFeeTransfer
boolean
Indica se taxas devem ser repassadas ao consumidor
Não
amount
decimal
Valor total a ser cobrado
Sim
description
string
Descrição da venda
Sim
payment
object
Informações do pagamento
Sim
type
string
Tipo do pagamento
Sim
credit
Cartão de Crédito
installments
integer
Quantidade de prestações
Sim
cardId
integer
Identificar do cartão de crédito
Sim
splits
objeto
Divisões
Não
splitRuleId
int
Pode ser um ou mais
Sim
warrantyDays
int
Tempo em Dias de Garantia do Serviço
Não
whenShouldIssueNfe
object
Quando emitir a NFe
Sim, se propridade sendNfeToCustomer for utilizada
0
int
No ato da Venda
1
int
Após a garantia
2
int
Não emitir
sendNfeToCustomer
boolean
Enviar nota fiscal ao consumidor
Sim, se propridade whenShouldIssueNfe for utilizada

Exemplo de Requisição

Este é um exemplo de como a sua requisição para adicionar uma ordem de pagamento com Cartão de Crédito deve parecer.
{
"customerId": 2345,
"fingerPrint": "db69792c-3b10-11eb-adc1-0242ac120002",
"includeFeeTransfer": false,
"amount": 275.50,
"description": "Descrição da venda",
"payment": {
"type": "credit",
"installments": 5,
"cardId": 8742
},
"splits": [
{
"splitRuleId": 527
},
{
"splitRuleId": 528
}
],
warrantyDays: 30,
whenShouldIssueNfe: 0,
sendNfeToCustomer: true
}

Respostas

200: Created

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
Status
Significado
new
Novo
succeded
Criado
canceled
Cancelado
failed
Falhou
pending
Pendente
blocked
Bloqueado
{
"id": 198564,
"storeId": 7591,
"number": "P278050",
"includeFeeTransfer": false,
"amount": 275.50,
"netAmount": 270.00,
"fee": 5.50,
"splits": [
{
"splitRule": {
"id": 527,
"recipient": {
"id": 347,
"name": "Store Comissionada"
},
"type": "Percentage",
"disputeLiable": false,
"refundLiable": false,
"percentage": 1.00,
"fixed": 0.00
},
"saleCommission": {
"amount": 2.75,
"status": "Succeded",
"createdOn": "2021-08-19T18:52:10.9597658Z"
},
"splitRule": {
"id": 528,
"recipient": {
"id": 349,
"name": "Store Comissionada"
},
"type": "Percentage",
"disputeLiable": false,
"refundLiable": false,
"percentage": 0.00,
"fixed": 2.50
},
"saleCommission": {
"amount": 2.50,
"status": "Succeded",
"createdOn": "2021-08-19T18:52:10.9597658Z"
}
}
],
"description": "Descrição da venda",
"status": "Succeded",
"createdOn": "2020-07-24T13:35:03.145Z",
"customer": {
"id": 2345,
"firstName": "Jorge Noah",
"surname": "Barbosa",
"birthdate": "1975-10-10",
"identificationNumber": "90202017940",
"email": "[email protected]",
"phone": "(48) 998711234"
},
"payment": {
"id": 197485,
"number": "b10da7c0347b40cc8c34664cb60445c0",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"fraudScore": {
"score": 37.06
},
"createdOn": "2020-07-24T13:35:03.145Z",
"status": "Succeded"
}
}

400: Bad Request

Esta é a resposta para os casos em que o servidor não processa a requisição devido a um erro encontrado. Alguns exemplos que podem resultar neste erro são uma URL digitada incorretamente, sintaxe malformada ou requisição de roteamento inválida. Códigos de erro relacionados à autorização do pagamento são retornados no campo errorCode.
{
"errorCode": 101,
"errors": [
{
"message": "Error description"
}
],
"status": 400,
"detail": "Error details"
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"status": 401
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"status": 403
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"status": 500,
"detail": "Error details"
}

Listar Ordem de Pagamento

https://api.premepay.com/v1/stores/{storeId}/orders
Parâmetro
Tipo
Descrição
Obrigatório
name
string
Nome do consumidor
Não
identificationNumber
string
Cpf ou CNPJ do consumidor
Não
number
string
Número da ordem
Não
pageSize
integer
Número de registros por página
Não
pageIndex
integer
Número da página
Não
Através da rota acima você poderá visualizar uma lista de todas as ordens de pagamento. Confira abaixo as respostas possíveis da API da Preme Pay para essa requisição.

Respostas

200: Ok

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
{
"results": [
{
"id": 198564,
"storeId": 7591,
"number": "P278050",
"includeFeeTransfer": false,
"amount": 275.50,
"netAmount": 270.00,
"fee": 5.50,
"description": "Descrição da venda",
"status": "Succeded",
"createdOn": "2020-07-24T13:35:03.145Z",
"customer": {
"id": 2345,
"firstName": "Jorge Noah",
"surname": "Barbosa",
"birthdate": "1975-10-10",
"identificationNumber": "90202017940",
"email": "[email protected]",
"phone": "(48) 998711234"
},
"payment": {
"id": 197485,
"number": "b10da7c0347b40cc8c34664cb60445c0",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"fraudScore": {
"score": 37.06
},
"createdOn": "2020-07-24T13:35:03.145Z",
"status": "Succeded"
}
}],
"totalNumber": 1
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"status": 401
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"status": 403
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"status": 500,
"detail": "Error details"
}

Detalhes da Ordem de Pagamento

https://api.premepay.com/v1/stores/{storeId}/orders/{orderNumber}
Com a API da Preme Pay e a rota acima você pode visualizar os detalhes de uma ordem de pagamento.

Respostas

200: Ok

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
{
"id": 198564,
"storeId": 7591,
"number": "P278050",
"includeFeeTransfer": false,
"amount": 275.50,
"netAmount": 270.00,
"fee": 5.50,
"description": "Descrição da venda",
"status": "Succeded",
"createdOn": "2020-07-24T13:35:03.145Z",
"customer": {
"id": 2345,
"firstName": "Jorge Noah",
"surname": "Barbosa",
"birthdate": "1975-10-10",
"identificationNumber": "90202017940",
"email": "[email protected]",
"phone": "(48) 998711234"
},
"payment": {
"id": 197485,
"number": "b10da7c0347b40cc8c34664cb60445c0",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"fraudScore": {
"score": 37.06
},
"createdOn": "2020-07-24T13:35:03.145Z",
"status": "Succeded"
}
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"status": 401
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"status": 403
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"status": 500,
"detail": "Error details"
}

Excluir Ordem de Pagamento

https://api.premepay.com/v1/stores/{storeId}/orders/{orderNumber}
Você tem a possibilidade de excluir permanentemente uma ordem de pagamento. Tenha atenção ao realizar essa requisição já que a ação não pode ser revertida.
A ação de excluir uma ordem de pagamento é permanente e não pode ser revertida.

Respostas

200: Ok

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
{
"message": "Order deleted"
}

400: Bad Request

Esta é a resposta para os casos em que o servidor não processa a requisição devido a um erro encontrado. Alguns exemplos que podem resultar neste erro são uma URL digitada incorretamente, sintaxe malformada ou requisição de roteamento inválida.
{
"errors": [
{
"message": "Error description"
}
],
"status": 400,
"detail": "Error details"
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"status": 401
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"status": 403
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"status": 500,
"detail": "Error details"
}
Copy link
Outline
Adicionar Ordem de Pagamento
Listar Ordem de Pagamento
Detalhes da Ordem de Pagamento
Excluir Ordem de Pagamento