Cartão
Realize vendas para mais de 135 países ao redor do mundo utilizando cartão de crédito ou débito.

Ordem de Pagamento Internacional

Para efetuar uma cobrança via Cartão de Crédito ou Débito, você deve criar uma ordem de pagamento internacional. Nesta seção você encontrará informações detalhadas relacionadas ao método de pagamento com cartão.
Importante: para que uma Ordem de Pagamento Internacional seja processada, é necessário a utilização do elemento "currency" no corpo da requisição o código ISO da moeda ao qual a Ordem de Pagamento Internacional será efetuada, como pode ser visto no exemplo abaixo. Para Ordem nacional utilizando a moeda brasileira Real, por favor, siga o método definido em Cartão de Crédito.
Verifique abaixo, a lista de códigos ISO das moedas suportadas:
  • USD
  • AED
  • AFN*
  • ALL
  • AMD
  • ANG
  • AOA*
  • ARS*
  • AUD
  • AWG
  • AZN
  • BAM
  • BBD
  • BDT
  • BGN
  • BIF
  • BMD
  • BND
  • BOB*
  • BRL*
  • BSD
  • BWP
  • BZD
  • CAD
  • CDF
  • CHF
  • CLP*
  • CNY
  • COP*
  • CRC*
  • CVE*
  • CZK*
  • DJF*
  • DKK
  • DOP
  • DZD
  • EGP
  • ETB
  • EUR
  • FJD
  • FKP*
  • GBP
  • GEL
  • GIP
  • GMD
  • GNF*
  • GTQ*
  • GYD
  • HKD
  • HNL*
  • HRK
  • HTG
  • HUF*
  • IDR
  • ILS
  • INR*
  • ISK
  • JMD
  • JPY
  • KES
  • KGS
  • KHR
  • KMF
  • KRW
  • KYD
  • KZT
  • LAK*
  • LBP
  • LKR
  • LRD
  • LSL
  • MAD
  • MDL
  • MGA
  • MKD
  • MMK
  • MNT
  • MOP
  • MRO
  • MUR*
  • MVR
  • MWK
  • MXN
  • MYR
  • MZN
  • NAD
  • NGN
  • NIO*
  • NOK
  • NPR
  • NZD
  • PAB*
  • PEN*
  • PGK
  • PHP
  • PKR
  • PLN
  • PYG*
  • QAR
  • RON
  • RSD
  • RUB
  • RWF
  • SAR
  • SBD
  • SCR
  • SEK
  • SGD
  • SHP*
  • SLL
  • SOS
  • SRD*
  • STD*
  • SZL
  • THB
  • TJS
  • TOP
  • TRY
  • TTD
  • TWD
  • TZS
  • UAH
  • UGX
  • UYU*
  • UZS
  • VND
  • VUV
  • WST
  • XAF
  • XCD
  • XOF*
  • XPF*
  • YER
  • ZAR
  • ZMW
Algumas exceções se aplicam para a lista de moedas:
  • Moedas marcadas com * não são suportadas pela American Express
  • As moedas listadas se aplicam ao pagamento com cartão

Moedas que não utilizam casas decimais

Para moedas que não possuem casas decimais, forneça o valor no formato inteiro. Por exemplo, para cobrar ¥500, forneça o valor 500 no elemento amount.
  • BIF
  • CLP
  • DJF
  • GNF
  • JPY
  • KMF
  • KRW
  • MGA
  • PYG
  • RWF
  • UGX
  • VND
  • VUV
  • XAF
  • XOF
  • XPF

Adicionar Ordem de Pagamento Internacional

https://api.premepay.com/v1/stores/{storeId}/orders
Utilizando a rota acima você pode adicionar uma ordem de pagamento internacional com Cartão 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
currency
string
Código alfa da moeda a ser processada. Exemplo: "GBP", "USD", "CAD"
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
Identificador
Sim
metadata
dictionary<string, object>
Dados adicionais
Não

Exemplo de Requisição

Este é um exemplo de como a sua requisição deve parecer para adicionar uma ordem de pagamento internacional com Cartão:
{
"customerId": 2345,
"fingerPrint": "db69792c-3b10-11eb-adc1-0242ac120002",
"includeFeeTransfer": false,
"amount": 275.50,
"currency": "gbp"
"description": "Order description goes here",
"payment": {
"type": "credit",
"installments": 5,
"cardId": 8742
},
"metadata": {
"order_id": "6735",
"reference": "29482",
},
}

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,
"currency": "gbp",
"description": "Order description goes here",
"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": "pi_1J1AUVG5kAD4X7zwIuEb9YMn",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"metadata": {
"order_id": "6735",
"reference": "29482",
},
"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,
"currency": "gbp",
"description": "Order description goes here",
"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": "pi_1J1AUVG5kAD4X7zwIuEb9YMn",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"metadata": {
"order_id": "6735",
"reference": "29482",
},
"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,
"currency": "gbp",
"description": "Order description goes here",
"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": "pi_1J1AUVG5kAD4X7zwIuEb9YMn",
"amount": 275.50,
"type": "Credit",
"installments": 5,
"card": {
"cardBrand": "Visa",
"holderName": "Jorge Noah Barbosa",
"expirationMonth": 2,
"expirationYear": 2026,
"firstDigits": "4539",
"lastDigits": "5497"
},
"metadata": {
"order_id": "6735",
"reference": "29482",
},
"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"
}
Last modified 1yr ago
Copy link
Outline
Ordem de Pagamento Internacional
Moedas que não utilizam casas decimais
Adicionar Ordem de Pagamento Internacional
Listar Ordem de Pagamento
Detalhes da Ordem de Pagamento
Excluir Ordem de Pagamento