Skip to main content
POST
Pagar uma sessão com múltiplos cartões

Authorizations

X-Client-Id
string
header
required
X-Api-Key
string
header
required

Headers

X-Idempotency-Key
string

Chave de idempotência da chamada. Quando ausente, a Malga gera uma a partir da sessão e dos cartões enviados

Path Parameters

id
string<uuid>
required

Identificador da sessão a ser paga

Body

application/json

Cartões da Venda e dados opcionais. Valor total, merchant, moeda, modo de captura, orderId e regras de split vêm da sessão

payments
object[]
required

Cartões da Venda, de 2 até o quantity configurado na sessão

Required array length: 2 - 3 elements
customerId
string<uuid>

Identificador de um customer para atribuir a Venda. Se ele não pertencer ao seu cliente, a Malga o ignora e o pagamento segue sem a atribuição

fraudAnalysis
object

Dados de antifraude da Venda, informados uma única vez. A Malga repete o objeto em cada cobrança da Venda. O campo faz parte da comparação de idempotência e nunca é retornado nas respostas, por conter dados pessoais do comprador. Dados de cartão em claro devolvem 422 com pan_not_allowed.

metadata
object

Pares de chave e valor livres, devolvidos na resposta. Dados de cartão em claro devolvem 422 com pan_not_allowed

Response

Venda aceita com status: pending, ou repetição idempotente com o estado atual da Venda. O corpo é o mesmo de POST /v1/purchases, com o sessionId da sessão

Venda paga com 2 ou 3 cartões

id
string<uuid>
required

Identificador da Venda

merchantId
string<uuid>
required

Identificador do merchant da Venda

amount
integer
required

Valor total da Venda em centavos

Required range: x >= 200
currency
enum<string>
required
Available options:
BRL
capture
boolean
required

Indica o modo de captura informado na criação. false exige captura explícita; true captura automaticamente

status
enum<string>
required

Status da Venda

Available options:
pending,
paid,
failed,
cancelled
payments
object[]
required
Required array length: 2 - 3 elements
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
pendingReview
object

Sinal de que a Venda precisa de revisão. A Venda permanece pending e você deve interromper o polling automático

activeOperation
object

Operação pending ou processing em andamento na Venda (a mais recente). Omitido quando não há operação ativa. Nas respostas 202, a operação aceita vem em operation

orderId
string | null

Identificador do pedido no seu sistema

sessionId
string<uuid> | null

Session de origem informada na criação

metadata
object

Metadados informados na criação. Omitido quando não enviados

splitRules
object[]

Regras de split informadas na criação. Omitido quando não enviadas

operation
object

Operação assíncrona aceita por esta chamada. Na criação, vem com type: authorize e pode ser omitida numa repetição idempotente