O fluxo básico de pagamentos no Pagar.me o qual começa com os pedidos. O pedido é da entidade do gateway que descreve a venda feita ao consumidor e nele consta informações dos itens do carrinho, dados do consumidor, endereço de entrega e forma de cobrança. Quando um pedido fechado é criado, automaticamente é gerado uma cobrança (payment). 

Exemplo de pedido com cobrança de cartão de crédito 

Quando criado um pedido com um item no valor de R$500,00 para ser pago por cartão de crédito, será criada uma cobrança de R$500,00 referente a este pedido no cartão informado.

Passo a passo fácil

A autenticação é feita com o AccessToken e a PublicKey ambos obtidos na instalação. Saiba mais.

1) Tokenizar o cartão com os dados básicos no front end

POST   https://hubapi.pagar.me/core/v5/tokens?appId=pk_xxxxxxXXXXXX

{
  "type": "card",
  "card": {
    "number": "4000000000000010",
    "holder_name": "Tony Stark",
    "exp_month": 1,
    "exp_year": 30,
    "cvv": "651",
    "label": "Sua bandeira"
  }
}

Saiba como tokenizar de forma correta!
 

2) Criar o pedido com cartão tokenizado

POST https://hubapi.pagar.me/core/v1/orders/

Authorization: Basic ODc5ZDAyMzU4OGJhYmE3YTgyZGE1ODkwOWExYjY2MmU0ZTU1YWE2MzQ1YzY4ZjA5MDZhYmU1ZjYwMGI2ODBhYjo=
 

{
  "customer": {
    "phones": {
      "home_phone": {
        "country_code": "55",
        "area_code": "21",
        "number": "000000000"
      }
    },
    "name": "Tony Stark",
    "email": "avengerstark@ligadajustica.com.br",
    "type": "individual",
    "document": "03154435026",
    "address": {
    	"line_1": "866, Avenida Presidente Kennedy, Vila Maria",
    	"line_2": "8º andar",
    	"zip_code": "78710848",
    	"city": "Rondonopolis",
    	"state": "MT",
    	"country": "BR"
  	}
  },
  "items": [
    {
      "amount": 2990,
      "description": "Chaveiro do Tesseract",
      "quantity": 1,
      "code": 123
    }
  ],
  "payments": [
    {
      "payment_method": "credit_card",
      "credit_card": {
        "installments": 1,
        "statement_descriptor": "AVENGERS",
        "card_token": "token_rJVKnbFBLTWWK8QD",
        "operation_type": "auth_and_capture",
        "card": {
			"options": {
          				"verify_card": true
  			},
          	"billing_address": {
            	"line_1": "375, Av. General Osorio, Centro",
            	"line_2": "7º Andar",
            	"zip_code": "220000111",
            	"city": "Rio de Janeiro",
            	"state": "RJ",
            	"country": "BR"
          }
        }
      },
    }
  ]
}

Referências

• Referência | Como criar um pedido 
• Visão Geral | Cartão de Crédito
• Referência | Como criar o token do cartão
• Guia | Como tokenizar da forma correta