curl --request POST \
--url https://api.malga.io/v1/sessions/{id}/charge \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--data '
{
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"paymentSource": {
"sourceType": "card",
"card": {
"cardNumber": "5261424250184574",
"cardCvv": "321",
"cardExpirationDate": "06/2028",
"cardHolderName": "JOAO DA SILVA"
}
}
}
'{
"id": "a1d455eb-dafe-4a5c-b882-a5775422f850",
"clientId": "d353deef-dacb-40a0-8cab-931ff773f274",
"merchantId": "a1d455eb-dafe-4a5c-b882-a5775422f850",
"description": "Descrição longa da cobrança",
"orderId": "df8d2258-bf33-44e7-97d1-c4b9d0bedf7f",
"createdAt": "2012-06-30 23:59:59 +0000",
"amount": 150,
"originalAmount": 150,
"currency": "BRL",
"statementDescriptor": "LOJA JOAO",
"status": "pending",
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"paymentSource": {
"sourceType": "card",
"cardId": "a1d455eb-dafe-4a5c-b882-a5775422f850"
},
"transactionRequests": [
{
"id": "2405d3ad-886e-4541-bd2e-8489e6f54dd4",
"idempotencyKey": "4ce7b3f5eb66499c96922fae84a8bf9e",
"providerId": "3022c70f-650f-4ef6-86e3-3b876df8948a",
"providerType": "STRIPE",
"transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
"amount": 1500,
"authorizationNsu": "83abd7e6-2223-4773-b1ef-aee98be1ee99",
"requestStatus": "success",
"requestType": "authorization",
"responseTs": "2633ms",
"createdAt": "2021-08-12T16:08:39.536Z",
"updatedAt": "2021-08-12T16:08:42.212Z",
"providerAuthorization": {
"networkAuthorizationCode": "00",
"networkResponseCode": ""
}
}
]
}Pagar uma sessão
Inicia uma cobrança para a sessão. Em sessões 1:N, cada chamada aceita representa uma tentativa individual dentro da capacidade configurada em maxPayments. A resposta é a cobrança criada e não retorna multiplePayments; consulte GET /v1/sessions/{id} para acompanhar o estado agregado atualizado.
Sessões com múltiplos cartões (paymentType: multiple) não são pagas por este endpoint: use POST /v1/sessions/{id}/purchase.
curl --request POST \
--url https://api.malga.io/v1/sessions/{id}/charge \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--data '
{
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"paymentSource": {
"sourceType": "card",
"card": {
"cardNumber": "5261424250184574",
"cardCvv": "321",
"cardExpirationDate": "06/2028",
"cardHolderName": "JOAO DA SILVA"
}
}
}
'{
"id": "a1d455eb-dafe-4a5c-b882-a5775422f850",
"clientId": "d353deef-dacb-40a0-8cab-931ff773f274",
"merchantId": "a1d455eb-dafe-4a5c-b882-a5775422f850",
"description": "Descrição longa da cobrança",
"orderId": "df8d2258-bf33-44e7-97d1-c4b9d0bedf7f",
"createdAt": "2012-06-30 23:59:59 +0000",
"amount": 150,
"originalAmount": 150,
"currency": "BRL",
"statementDescriptor": "LOJA JOAO",
"status": "pending",
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"paymentSource": {
"sourceType": "card",
"cardId": "a1d455eb-dafe-4a5c-b882-a5775422f850"
},
"transactionRequests": [
{
"id": "2405d3ad-886e-4541-bd2e-8489e6f54dd4",
"idempotencyKey": "4ce7b3f5eb66499c96922fae84a8bf9e",
"providerId": "3022c70f-650f-4ef6-86e3-3b876df8948a",
"providerType": "STRIPE",
"transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
"amount": 1500,
"authorizationNsu": "83abd7e6-2223-4773-b1ef-aee98be1ee99",
"requestStatus": "success",
"requestType": "authorization",
"responseTs": "2633ms",
"createdAt": "2021-08-12T16:08:39.536Z",
"updatedAt": "2021-08-12T16:08:42.212Z",
"providerAuthorization": {
"networkAuthorizationCode": "00",
"networkResponseCode": ""
}
}
]
}Body
Corpo para pagamento da sessão (paymentMethod e paymentSource). Se existir split, as regras foram definidas na criação da sessão (splitRules em POST /v1/sessions) e são aplicadas ao processar esta cobrança; não envie splitRules aqui.
Opcional. Bandeira do cartão usado no pagamento (visa, mastercard, american-express, elo, hipercard, hiper, diners-club, discover, jcb ou unionpay). O checkout da Malga já envia o campo; informe-o se você paga a sessão com checkout próprio.
Só tem efeito em pagamentos com credit ou click_to_pay de sessões com vendor sem paymentFacilitatorId: a Malga usa o código cadastrado para essa bandeira em códigos de facilitador por bandeira. Bandeira ausente, inválida ou sem código cadastrado não bloqueia o pagamento: a transação segue só com o id do vendedor.
"mastercard"
Response
Created
Was this page helpful?