1. Criando um Pagamento
Api Expert
  • Documentos
    • Rakim Expert
    • Homologação
      • Processo de Homologação
    • Autenticação na API
    • Pagamentos
      • Introdução
      • Fingerprint
      • Criando um Pagamento
        • sales
          POST
      • Criando Pagamento com Split
        • sales/splits
      • Capturando um Pagamento Pré-Autorizado
        • capture
      • Cancelando um Pagamento
        • cancel
      • Consultando informações do Pagamento
        • consulta
      • Ativando um Split Tardio
        • Split tardio
      • Como Criar um Cofre de Cartão
        • vault
      • Inativar cofre de cartão
        • inativar vault
      • Listar os Cartões do Cofre
        • Lista vault
      • Consultando as Taxas da Transação
        • Consultar taxas
      • Listar Pagamentos
        • Listar pagamentos
      • Cartões de Teste
      • Códigos de Retorno
      • Casos de Uso
    • PIX
      • Introdução
      • Criar Cobrança Pix
        • Cobranca pix
      • Consultar Cobrança Pix
        • Cobranca pix
      • Devolução de Pagamento Pix
        • Devolução pix
    • Link de Pagamento
      • Introdução
      • Criar Link de Pagamento
        • Criar Link de Pagamento
      • Upload do Logo para Link de Pagamento
        • Upload logo
    • Recorrência
      • Introdução
      • Criar Recorrência
        • Criar Recorrência
      • Criar Link de Recorrência
        • Criar link
    • Estabelecimentos
      • Introdução
      • Criar Estabelecimento
        • Criar Estabelecimento
      • Upload de documentos
        • Upload de Documentos
      • Buscar Estabelecimento
        • Busca estabelecimento
      • Listar CNAE's
        • Listar CNAE's
      • Listar Bancos
        • Listar Bancos
      • Casos de Uso
    • Liquidações
      • Saque
        • Solicitar Saque
      • Saldo
        • Consultar Saldo
      • Extrato
        • Busca extrato
      • Extrato Analítico
        • Busca extrato
      • Extrato Futuro
        • Busca extrato
    • Antecipações
      • Introdução
      • Atualizar Antecipação Automática
        • Atualização Antecipação
      • Listar Antecipações Disponíveis
        • Listar Antecipações
      • Solicitar Antecipação
        • Solicitar Antecipação
    • Webhook's
      • Cadastrar Webhook
        • Cadastrar Webhook
      • Reenvio de Webhook de Pagamento
        • Reenvio de Webhook de Pagamento
      • Reenvio de Webhook de Estabelecimento
        • Reenvio de Webhook de Estabelecimento
      • Exemplo de Webhook
    • Status
      • Status de Pagamento
  1. Criando um Pagamento

sales

Amb. de Produção
https://api-expert.rakim.com.br
Amb. de Produção
https://api-expert.rakim.com.br
POST
https://api-expert.rakim.com.br
/payments/api/sales

API Documentation#

Schemas#

PaymentRequest#

NomeTipoDescriçãoRequiredDefault
amountnumberValor do pagamento em centavos, sem vírgula e ponto.Sim
order_idstringSeu Número do Pedido.Não
online_idstringSeu Número de Identificação da Compra.Não
paymentPaymentInformações do pagamento, modelo de autorização e fluxo a ser executado.Sim
customerCustomerInformações relacionados ao cliente vinculado ao pagamento.Sim
metadataMetadataO parâmetro metadata permite insirir "Chave e Valor" como informações adicionais a uma transação.Não

Payment#

NomeTipoDescriçãoRequiredDefault
typestringTipo de pagamento (ex: credit / debit).Sim
installmentsnumberNúmero de parcelas do pagamento.Sim
capturebooleanIndica se o pagamento deve ser autorizado no momento da criação. Valores possíveis: Autorização - true, Pré-Autorização - false.Nãofalse
has_interestbooleanIndica se o pagamento possui juros.Nãofalse
authenticatebooleanIndica se o pagamento terá dupla autenticação junto ao Banco Emissor do cartão com 3DS. Valores possíveis: Fluxo Normal - False ou Autenticação 3DS - trueNãofalse
softdescriptorstringTexto exibido na Fatura do cartão do Comprador.Não
currency_codestringMoeda na qual o pagamento será processado. Valores possíveis: BRLNãoBRL
cardCardInformações do Cartão do Comprador.Não

Card#

NomeTipoDescriçãoRequiredDefault
holderstringNome do comprador impresso no cartão. Obrigatório caso o pagamento não seja tokenizado.Não
numberstringNúmero do cartão do comprador. Obrigatório caso o pagamento não seja tokenizado.Não
expire_monthstringMês de expiração do cartão com dois dígitos. Obrigatório caso o pagamento não seja tokenizado.Não
expire_yearstringAno de expiração do cartão com quatro dígitos. Obrigatório caso o pagamento não seja tokenizado.Não
brandstringBandeira do cartão. Valores possíveis: Visa, Mastercard, Amex, Elo, Hipercard.Sim
cvcstringCódigo de segurança impresso no cartão. Obrigatório caso o pagamento não seja tokenizado.Não
vaultstringIdentificador do cartão no cofre. Obrigatório caso o pagamento seja tokenizado.Não

Customer#

NomeTipoDescriçãoRequiredDefault
namestringNome do comprador.Sim
documentstringNúmero do documento (CPF) do comprador.Sim
emailstringE-mail do comprador.Não
phonestringTelefone do comprador.Não
birthDatestringData de nascimento do comprador.Não
ipstringEndereço IP do dispositivo do comprador.Não
billing_addressstringEndereço de cobrança.Não
shipping_addressstringEndereço de envio.Não

Address#

NomeTipoDescriçãoRequiredDefault
streetstringNome da rua.Não
numberstringNúmero do endereço.Não
districtstringBairro.Não
complementstringComplemento do endereço.Não
citystringCidade.Não
statestringEstado abreviado. Ex: SPNão
zipcodestringCEP sem pontuações. Ex: 01451000Não
countrystringPaís. Ex: BrasilNão

Metadata#

NomeTipoDescriçãoRequiredDefault
keystringChave de metadadosNão
valuestringValor dos metadadosNão

Requisição

Nenhum

Respostas

🟢200
application/json
Bodyapplication/json

🟠400
🟠401
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-expert.rakim.com.br/payments/api/sales'
Response Response Example
200 - Sucesso
{
    "status": 3,
    "returnCode": "0",
    "returnMessage": "Sucesso",
    "message": "SUCESSO",
    "paymentId": "010000003811041456460000064215020000000000",
    "authorizationCode": "007019",
    "orderNumber": "6183f4ac7ad8d",
    "onlineId": "HROJSF",
    "type": "credit",
    "delayed_split": false,
    "installments": 1,
    "brand": "mastercard",
    "amount": 3990,
    "fees": 260,
    "liquid": 3730,
    "acquirer": "adiq",
    "metadata": [
        {
            "metadata_key": "key",
            "metadata_value": "value"
        },
        {
            "metadata_key": "key2",
            "metadata_value": "value2"
        }
    ],
    "createdAt": "2021-11-04 11:56:50",
    "expireAt": "2021-11-11 11:56:50",
    "first4Digits": "5201",
    "last4Digits": "5011",
    "nsu": "61a7d95711f57",
    "customer": {
        "name": "Comprador Teste",
        "document": "99999999999",
        "email": "example@test.com",
        "phone": "11999999999",
        "birthDate": "1969-12-31",
        "billingAddress": {
            "street": "Rua teste",
            "number": "1",
            "district": "Bairro teste",
            "complement": "Complemento teste",
            "zipcode": "99999999",
            "city": "São Paulo",
            "state": "SP",
            "country": "BRA"
        }
    }
}
Modificado em 2026-02-27 12:18:13
Página anterior
Criando um Pagamento
Próxima página
Criando Pagamento com Split
Built with