Skip to main content
POST
/
v1
/
sessions
/
{id}
/
charge
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": "148d5db0-f1c3-439f-902d-f1f268086e1d",
  "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
  "merchantId": "148d5db0-f1c3-439f-902d-f1f268086e1d",
  "description": "Descrição longa da cobrança",
  "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
  "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": "148d5db0-f1c3-439f-902d-f1f268086e1d"
  },
  "transactionRequests": [
    {
      "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
      "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
      "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
      "providerType": "STRIPE",
      "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
      "amount": 1500,
      "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
      "requestStatus": "success",
      "requestType": "authorization",
      "responseTs": "2633ms",
      "createdAt": "2021-08-12T16:08:39.536Z",
      "updatedAt": "2021-08-12T16:08:42.212Z",
      "providerAuthorization": {
        "networkAuthorizationCode": "00",
        "networkResponseCode": ""
      }
    }
  ]
}

Authorizations

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

Path Parameters

​
id
string<uuid>
required

Identificação da sessão a ser paga

Body

application/json

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.

​
paymentMethod
Cartão · object
required

Define o método de cobrança

​
paymentSource
Cartão tokenizado · object
required

Dados para cobrança por cartão de crédito salve

​
customerId
string<uuid>

Identificador de comprador para consulta futura

​
fraudAnalysis
object

Parâmetros adicionais para análise de fraude. Alguns destes campos podem ser necessários para processar com provedores específicos.

Response

201 - application/json

Created

​
id
string

Identificador da transação

​
clientId
string<uuid>

Identificador do cliente na Malga

​
merchantId
string<uuid>

Identificador do merchant id utilizado na transação

​
description
string

Descrição da cobrança para consulta futura

​
orderId
string

Identificador único da cobrança do lado do cliente para conciliação futura

​
createdAt
string

Data de criação do cartão

​
amount
number

Valor da transação em centavos, exemplo 100 para cobrar R$ 1,00

​
originalAmount
number

Valor original da transação em centavos, exemplo 100 para cobrar R$ 1,00

​
currency
string
default:BRL

Identificador da moeda para processamento da cobrança, formato ISO 4217.

​
statementDescriptor
string

Descrição a ser exibida na fatura do comprador

​
status
enum<string>

Status da sessão

Available options:
created,
paid,
canceled,
voided
​
paymentMethod
Cartão de crédito · object
​
paymentSource
Cartão de crédito · object

dados para cobrança por cartão de crédito salve

​
transactionRequests
object[]