POST
/
v1
/
charges
/
{id}
curl --request POST \
  --url https://api.malga.io/v1/charges/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '{
  "status": "charged_back"
}'
{
  "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
  "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
  "createdAt": "2012-06-30 23:59:59 +0000",
  "amount": 150,
  "currency": "BRL",
  "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
  "statementDescriptor": "LOJA JOAO",
  "description": "Descrição longa da cobrança",
  "capture": false,
  "isDispute": false,
  "status": "pre_authorized",
  "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": ""
      }
    }
  ],
  "appInfo": {
    "platform": {
      "integrator": "malga",
      "name": "pluging-vtex-ppp",
      "version": "1.12"
    },
    "device": {
      "name": "iOS",
      "version": "10.12"
    },
    "system": {
      "name": "VTEX",
      "version": "13.12"
    }
  }
}

Authorizations

X-Client-Id
string
headerrequired
X-Api-Key
string
headerrequired

Path Parameters

id
string
required

id da cobrança que deseja alterar no sandbox

Body

application/json
status
enum<string>

status da transação

Available options:
pending,
pre_authorized,
authorized,
failed,
canceled,
voided,
charged_back,
created,
processed,
refund_pending,
capture_pending

Response

200 - 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

customerId
string

identificador do customer id

description
string

Descrição da cobrança para consulta futura

amount
number

valor 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

capture
boolean

determina se a transação deve ser capturada automaticamente

isDispute
boolean

determina se a transação está em disputa

status
enum<string>

status da transação na Malga

Available options:
pending,
pre_authorized,
authorized,
failed,
canceled,
voided,
charged_back,
refund_pending,
capture_pending
orderId
string

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

paymentMethod
object
paymentSource
object

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

createdAt
string

Data de criação do cartão

updatedAt
string

Data de atualização do cartão

fraudAnalysisMetadata
object

Parâmetros adicionais para analise de fraude

paymentFlow
object

Campos adicionais para uso em condicionais dos fluxos inteligentes

transactionRequests
object[]
threeDSecure2
object
appInfo
object

Informações sobre a rastreabilidade da cobrança