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
headerrequired
X-Api-Key
string
headerrequired

Path Parameters

id
string
required

Identificação da sessão a ser paga

Body

application/json
customerId
string

Identificador de comprador para consulta futura

paymentMethod
object
required

Define o método de cobrança

paymentSource
object
required

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

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
id
string

Identificador da transação

clientId
string

Identificador do cliente na Malga

merchantId
string

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
object
paymentSource
object

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

transactionRequests
object[]