Create Order

curl -X POST "{{host}}/api/v1/orders" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 123,
    "denomination": 50.00,
    "quantity": 5,
    "ref": "MY_ORDER_001",
    "client_reference": "CAMPAIGN_Q1_2025",
    "email": "recipient@example.com"
  }'

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

type CreateOrderRequest struct {
    ProductID       int     `json:"product_id"`
    Denomination    float64 `json:"denomination"`
    Quantity        int     `json:"quantity"`
    WalletID        *int    `json:"wallet_id,omitempty"`
    Ref             string  `json:"ref,omitempty"`
    ClientReference string  `json:"client_reference,omitempty"`
    Email           string  `json:"email,omitempty"`
}

type Voucher struct {
    CardNumber             *string `json:"card_number"`
    PinCode                *string `json:"pin_code"`
    ClaimURL               *string `json:"claim_url"`
    ExpiresAt              *string `json:"expires_at"`
    VoucherReferenceNumber *string `json:"voucher_reference_number"`
}

type OrderResponse struct {
    ID                int       `json:"id"`
    ProductID         int       `json:"product_id"`
    ProductName       string    `json:"product_name"`
    Denomination      float64   `json:"denomination"`
    Quantity          int       `json:"quantity"`
    Amount            float64   `json:"amount"`
    Discount          float64   `json:"discount"`
    Ref               string    `json:"ref"`
    ClientReference   string    `json:"client_reference"`
    WalletID          int       `json:"wallet_id"`
    Status            string    `json:"status"`
    BaseCurrency      string    `json:"base_currency"`
    DeductionCurrency string    `json:"deduction_currency"`
    Message           string    `json:"message"`
    Email             string    `json:"email"`
    Vouchers          []Voucher `json:"vouchers"`
}

func main() {
    body, _ := json.Marshal(CreateOrderRequest{
        ProductID:    123,
        Denomination: 50.00,
        Quantity:     5,
        Ref:          "MY_ORDER_001",
    })

    req, _ := http.NewRequest("POST", "{{host}}/api/v1/orders", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var order OrderResponse
    json.NewDecoder(resp.Body).Decode(&order)

    fmt.Printf("Order #%d — %s (%s)\n", order.ID, order.Status, order.Message)
    for _, v := range order.Vouchers {
        if v.CardNumber != nil {
            fmt.Printf("  Code: %s / PIN: %s\n", *v.CardNumber, *v.PinCode)
        }
        if v.ClaimURL != nil {
            fmt.Printf("  URL: %s\n", *v.ClaimURL)
        }
    }
}

{
  "error": {
    "name": "ValidationException",
    "code": "VALIDATION_FAILURE",
    "message": "Invalid product_id: required"
  }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Duplicate reference code"
  }
}

{
  "error": {
    "name": "NotFoundError",
    "code": "NOT_FOUND",
    "message": "Product not found"
  }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Denomination not available for this product"
  }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Invalid quantity, allowed max quantity: 100"
  }
}

{
  "error": {
    "name": "NotFoundError",
    "code": "NOT_FOUND",
    "message": "Wallet not found"
  }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Insufficient funds in your wallet"
  }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "forex rate not available for EUR to GBP conversion"
  }
}

{
  "error": {
    "name": "UnauthorizedError",
    "code": "UNAUTHORIZED",
    "message": "Authorization header required"
  }
}