Adicionar saldo em customer | GoMoney

curl -X POST https://gmc-api.gomoney.me/api/transactions/add-balance \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "amount": 1500.75,
  "customerIdentifier": "a3f1c9d2e4b5678901234567",
  "currency": "GMC"
}'

{
  "title": "Success",
  "balanceTransaction": {
    "_id": "a3f1c9d2e4b5678901234568",
    "user": "b4e2d3f4a5c6789012345678",
    "status": "COMPLETED",
    "summary": {
      "totalItems": 1,
      "completedItems": 1,
      "failedItems": 0,
      "totalTargetGmc": 1500.75
    },
    "items": [
      {
        "customerIdentifier": "a3f1c9d2e4b5678901234567",
        "sourceAmount": 1500.75,
        "sourceCurrency": "GMC",
        "targetGmcAmount": "1500.75",
        "status": "COMPLETED",
        "error": null,
        "customerWalletAddress": "0xAbC1234dEf567890aBcD1234567890EfABcDeF12",
        "destinationWalletAddress": "0xDeF4567aBc8901234dEfABcD567890aBcDeF1234",
        "fees": {
          "fixedBrl": 2.5,
          "percentageBrl": 0.75,
          "totalBrl": 3.25,
          "issueTaxBrl": 0.5,
          "issueTaxRate": 0.033,
          "fixedFeeSource": "customer",
          "percentageFeeSource": "user",
          "issueTaxSource": "settings"
        },
        "conversion": {
          "brlPerGmc": 0.95,
          "usdtBrlRate": 5.25,
          "sourceAmountBrl": 1425.71
        },
        "blockchain": {
          "mintHash": null,
          "approveHash": null,
          "transferHash": null
        },
        "processedAt": "1688006400"
      }
    ],
    "createdAt": "1688006400",
    "updatedAt": "1688006400"
  }
}

Endpoint de adição de saldo em customer para a integração documentada.

Este endpoint exige:

Authorization: Bearer <accessToken>
secret-key: btoa(clientKey:clientSecret)
Origin correspondente ao domínio liberado

O campo customerIdentifier é obrigatório e as taxas PIX seguem a hierarquia: customer -> user -> settings.

Endpoint de adição de saldo em customer para a integração documentada. Este endpoint exige: - `Authorization: Bearer <accessToken>` - `secret-key: btoa(clientKey:clientSecret)` - `Origin` correspondente ao domínio liberado O campo `customerIdentifier` é obrigatório e as taxas PIX seguem a hierarquia: `customer -> user -> settings`.

Authentication

AuthorizationBearer

Token retornado pelo endpoint /users/integration/login.

secret-keystring

Chave Base64 no formato btoa(clientKey:clientSecret).

Request

This endpoint expects an object.

amountdoubleRequired

customerIdentifierstringRequired

_id ou taxId do customer.

currencyenumRequired

Response

Adição de saldo em customer realizada com sucesso.

titlestring

balanceTransactionobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error