Process Payment

{
  "amount": 10000,
  "currency": "USD",
  "method": "card",
  "paymentMethodId": "pm_card_abc123",
  "description": "Premium Subscription - Monthly",
  "metadata": {
    "orderId": "order_12345",
    "plan": "premium_monthly"
  },
  "idempotencyKey": "payment-order_12345-2025-11-18"
}

{
  "amount": 5000,
  "currency": "USD",
  "method": "wallet",
  "sourceWalletId": "wallet_alice_usd",
  "destinationWalletId": "wallet_bob_usd",
  "description": "P2P transfer to Bob",
  "metadata": {
    "transferType": "p2p",
    "memo": "Dinner split"
  }
}

{
  "amount": 1000000,
  "currency": "USDC",
  "method": "crypto",
  "destinationWalletId": "wallet_merchant_usdc",
  "description": "NFT Purchase",
  "metadata": {
    "nftId": "nft_123",
    "collection": "cool_apes"
  }
}

{
  "amount": 50000,
  "currency": "USD",
  "method": "ach",
  "paymentMethodId": "pm_ach_xyz789",
  "description": "Monthly rent payment",
  "metadata": {
    "invoiceId": "inv_202511",
    "property": "123_main_st"
  }
}

{
  "id": "txn_9x8y7z6a5b4c",
  "type": "payment",
  "status": "completed",
  "amount": 10000,
  "currency": "USD",
  "fee": 320,
  "netAmount": 9680,
  "paymentMethodId": "pm_card_abc123",
  "description": "Premium Subscription - Monthly",
  "metadata": {
    "orderId": "order_12345",
    "plan": "premium_monthly"
  },
  "createdAt": "2025-11-18T22:30:00Z",
  "completedAt": "2025-11-18T22:30:02Z"
}

{
  "id": "txn_ach_pending_xyz",
  "type": "payment",
  "status": "processing",
  "amount": 50000,
  "currency": "USD",
  "fee": 500,
  "netAmount": 49500,
  "paymentMethodId": "pm_ach_xyz789",
  "description": "Monthly rent payment",
  "metadata": {
    "invoiceId": "inv_202511",
    "property": "123_main_st"
  },
  "createdAt": "2025-11-18T22:30:00Z",
  "completedAt": null,
  "estimatedCompletion": "2025-11-21T22:30:00Z"
}

{
  "error": "validation_error",
  "message": "Invalid payment method for currency",
  "code": "INVALID_PAYMENT_METHOD",
  "details": {
    "method": "ach",
    "currency": "EUR",
    "supportedMethods": ["card", "sepa", "wire", "crypto"]
  }
}

{
  "error": "insufficient_funds",
  "message": "Source wallet has insufficient balance",
  "code": "INSUFFICIENT_FUNDS",
  "details": {
    "required": 10000,
    "available": 5000,
    "currency": "USD",
    "walletId": "wallet_alice_usd"
  }
}

import { HedgePayments } from '@hedgepayments/sdk';

const hedge = new HedgePayments(process.env.HEDGE_API_KEY);

async function processPayment() {
  try {
    const transaction = await hedge.transactions.create({
      amount: 10000, // $100.00
      currency: 'USD',
      method: 'card',
      paymentMethodId: 'pm_card_abc123',
      description: 'Premium Subscription',
      metadata: {
        orderId: 'order_12345',
        customerId: 'cust_abc'
      },
      idempotencyKey: `payment-${Date.now()}`
    });

    if (transaction.status === 'completed') {
      console.log('Payment successful:', transaction.id);
      // Fulfill order
    } else {
      console.log('Payment pending:', transaction.status);
      // Wait for webhook
    }

    return transaction;
  } catch (error) {
    if (error.code === 'INSUFFICIENT_FUNDS') {
      console.log('Payment declined - insufficient funds');
    } else if (error.code === 'CARD_DECLINED') {
      console.log('Card declined by issuer');
    }
    throw error;
  }
}

from hedgepayments import HedgePayments
import time

hedge = HedgePayments(api_key=os.environ['HEDGE_API_KEY'])

def process_payment():
    try:
        transaction = hedge.transactions.create(
            amount=10000,  # $100.00
            currency='USD',
            method='card',
            payment_method_id='pm_card_abc123',
            description='Premium Subscription',
            metadata={
                'orderId': 'order_12345',
                'customerId': 'cust_abc'
            },
            idempotency_key=f'payment-{int(time.time())}'
        )

        if transaction.status == 'completed':
            print(f'Payment successful: {transaction.id}')
            # Fulfill order
        else:
            print(f'Payment pending: {transaction.status}')
            # Wait for webhook

        return transaction
    except HedgePayments.InsufficientFundsError:
        print('Payment declined - insufficient funds')
    except HedgePayments.CardDeclinedError:
        print('Card declined by issuer')

curl -X POST https://api.hedgepayments.com/v1/transactions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payment-order_12345-2025-11-18" \
  -d '{
    "amount": 10000,
    "currency": "USD",
    "method": "card",
    "paymentMethodId": "pm_card_abc123",
    "description": "Premium Subscription",
    "metadata": {
      "orderId": "order_12345"
    }
  }'

package main

import (
    "context"
    "fmt"
    "time"

    hedgepayments "github.com/hedgepayments/go-sdk"
)

func processPayment() error {
    client := hedgepayments.NewClient(os.Getenv("HEDGE_API_KEY"))

    txn, err := client.Transactions.Create(context.Background(), &hedgepayments.CreateTransactionRequest{
        Amount:          10000, // $100.00
        Currency:        "USD",
        Method:          "card",
        PaymentMethodID: "pm_card_abc123",
        Description:     "Premium Subscription",
        Metadata: map[string]string{
            "orderId":    "order_12345",
            "customerId": "cust_abc",
        },
        IdempotencyKey: fmt.Sprintf("payment-%d", time.Now().Unix()),
    })

    if err != nil {
        switch hedgepayments.ErrorCode(err) {
        case hedgepayments.InsufficientFunds:
            fmt.Println("Payment declined - insufficient funds")
        case hedgepayments.CardDeclined:
            fmt.Println("Card declined by issuer")
        default:
            return err
        }
    }

    if txn.Status == "completed" {
        fmt.Printf("Payment successful: %s\n", txn.ID)
        // Fulfill order
    } else {
        fmt.Printf("Payment pending: %s\n", txn.Status)
        // Wait for webhook
    }

    return nil
}

{
  "event": "transaction.completed",
  "data": {
    "id": "txn_abc123",
    "amount": 10000,
    "currency": "USD",
    "status": "completed",
    "completedAt": "2025-11-18T22:30:02Z"
  }
}

{
  "event": "transaction.failed",
  "data": {
    "id": "txn_abc123",
    "amount": 10000,
    "currency": "USD",
    "status": "failed",
    "failureReason": "card_declined"
  }
}