Skip to main content
POST
/
wallet_transactions
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/wallet_transactions" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "wallet_transaction": {
      "wallet_id": "wallet_1234",
      "paid_credits": "20.0",
      "granted_credits": "10.0"
    }
  }'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import WalletTransaction

client = Client(api_key='__YOUR_API_KEY__')

transaction = WalletTransaction(
  wallet_id='wallet_1234',
  paid_credits='20.0',
  granted_credits='10.0'
)

try:
    client.wallet_transactions.create(transaction)
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')

client.wallet_transactions.create({
    wallet_id: 'wallet_1234',
    paid_credits: '20.0',
    granted_credits: '10.0'
})

await client.walletTransactions.createWalletTransaction({
  wallet_transaction: {
    wallet_id: "wallet_1234",
    paid_credits: 20.0,
    granted_credits: 10.0,
  },
});

import "fmt"
import "github.com/getlago/lago-go-client"

func main() {
lagoClient := lago.New().
    SetApiKey("__YOUR_API_KEY__")

walletTransactionInput := &lago.WalletTransactionInput{
    WalletId:           "wallet_1234",
    PaidCredits:        "20.0"
    GrantedCredits:     "10.0",
}

transactions, err := lagoClient.WalletTransaction().Create(walletTransactionInput)
if err != nil {
    // Error is *lago.Error
    panic(err)
}

// wallet is *lago.Wallet
fmt.Println(transactions)
}

{
  "wallet_transactions": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_wallet_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_credit_note_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_voided_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "status": "settled",
      "source": "manual",
      "transaction_status": "purchased",
      "transaction_type": "inbound",
      "amount": "10.0",
      "credit_amount": "100.0",
      "invoice_requires_successful_payment": false,
      "metadata": [
        {
          "key": "example key",
          "value": "example value"
        },
        {
          "key": "another key",
          "value": "another value"
        }
      ],
      "remaining_amount_cents": 5000,
      "remaining_credit_amount": "5.0",
      "priority": 50,
      "settled_at": "2022-04-29T08:59:51Z",
      "failed_at": "2022-04-29T08:59:51Z",
      "created_at": "2022-04-29T08:59:51Z",
      "name": "Tokens for models 'high-fidelity-boost'",
      "payment_method": {
        "payment_method_type": "provider",
        "payment_method_id": "1a901a90-1a90-1a90-1a90-1a901a901a90"
      },
      "applied_invoice_custom_sections": [
        {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "created_at": "2023-07-06T14:35:58Z",
          "invoice_custom_section": {
            "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
            "name": "EU Bank Details",
            "code": "eu_bank_details",
            "description": "This section contains the bank details for EU customers.",
            "details": "Bank Name: Lago Bank, IBAN: FR7630004000031234567890143",
            "display_name": "Bank Details:",
            "applied_to_organization": true,
            "organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
            "created_at": "2023-07-06T14:35:58Z"
          },
          "invoice_custom_section_id": "1a901a90-1a90-1a90-1a90-1a901a901a90"
        }
      ]
    }
  ]
}
{
  "status": 400,
  "error": "Bad request"
}
{
  "status": 401,
  "error": "Unauthorized"
}
{
  "status": 403,
  "error": "Forbidden",
  "code": "feature_unavailable"
}
{
  "status": 422,
  "error": "Unprocessable entity",
  "code": "validation_errors",
  "error_details": {}
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/wallet_transactions" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "wallet_transaction": {
      "wallet_id": "wallet_1234",
      "paid_credits": "20.0",
      "granted_credits": "10.0"
    }
  }'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import WalletTransaction

client = Client(api_key='__YOUR_API_KEY__')

transaction = WalletTransaction(
  wallet_id='wallet_1234',
  paid_credits='20.0',
  granted_credits='10.0'
)

try:
    client.wallet_transactions.create(transaction)
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')

client.wallet_transactions.create({
    wallet_id: 'wallet_1234',
    paid_credits: '20.0',
    granted_credits: '10.0'
})

await client.walletTransactions.createWalletTransaction({
  wallet_transaction: {
    wallet_id: "wallet_1234",
    paid_credits: 20.0,
    granted_credits: 10.0,
  },
});

import "fmt"
import "github.com/getlago/lago-go-client"

func main() {
lagoClient := lago.New().
    SetApiKey("__YOUR_API_KEY__")

walletTransactionInput := &lago.WalletTransactionInput{
    WalletId:           "wallet_1234",
    PaidCredits:        "20.0"
    GrantedCredits:     "10.0",
}

transactions, err := lagoClient.WalletTransaction().Create(walletTransactionInput)
if err != nil {
    // Error is *lago.Error
    panic(err)
}

// wallet is *lago.Wallet
fmt.Println(transactions)
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Wallet transaction payload

​
wallet_transaction
object
required

Response

Wallet transaction created

​
wallet_transactions
object[]
required