Create a Draft Invoice

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const invoice = await client.invoices.create({
  collection_method: 'auto_charge',
  currency: 'AED',
  customer_id: 'customer_id',
  items: [
    {
      description: 'description',
      kind: 'custom',
      tax_category: 'digital_products',
      unit_amount: 0,
    },
  ],
});

console.log(invoice.amount_paid);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
invoice = client.invoices.create(
    collection_method="auto_charge",
    currency="AED",
    customer_id="customer_id",
    items=[{
        "description": "description",
        "kind": "custom",
        "tax_category": "digital_products",
        "unit_amount": 0,
    }],
)
print(invoice.amount_paid)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	invoice, err := client.Invoices.New(context.TODO(), dodopayments.InvoiceNewParams{
		CollectionMethod: dodopayments.F(dodopayments.CollectionMethodAutoCharge),
		Currency:         dodopayments.F(dodopayments.CurrencyAed),
		CustomerID:       dodopayments.F("customer_id"),
		Items: dodopayments.F([]dodopayments.InvoiceNewParamsItemUnion{dodopayments.InvoiceNewParamsItemsCustomItem{
			Description: dodopayments.F("description"),
			Kind:        dodopayments.F(dodopayments.InvoiceNewParamsItemsCustomItemKindCustom),
			TaxCategory: dodopayments.F(dodopayments.TaxCategoryDigitalProducts),
			UnitAmount:  dodopayments.F(int64(0)),
		}}),
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", invoice.AmountPaid)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.invoices.CollectionMethod;
import com.dodopayments.api.models.invoices.Invoice;
import com.dodopayments.api.models.invoices.InvoiceCreateParams;
import com.dodopayments.api.models.misc.Currency;
import com.dodopayments.api.models.misc.TaxCategory;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        InvoiceCreateParams params = InvoiceCreateParams.builder()
            .collectionMethod(CollectionMethod.AUTO_CHARGE)
            .currency(Currency.AED)
            .customerId("customer_id")
            .addItem(InvoiceCreateParams.Item.CustomItem.builder()
                .description("description")
                .taxCategory(TaxCategory.DIGITAL_PRODUCTS)
                .unitAmount(0)
                .build())
            .build();
        Invoice invoice = client.invoices().create(params);
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.invoices.CollectionMethod
import com.dodopayments.api.models.invoices.Invoice
import com.dodopayments.api.models.invoices.InvoiceCreateParams
import com.dodopayments.api.models.misc.Currency
import com.dodopayments.api.models.misc.TaxCategory

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val params: InvoiceCreateParams = InvoiceCreateParams.builder()
        .collectionMethod(CollectionMethod.AUTO_CHARGE)
        .currency(Currency.AED)
        .customerId("customer_id")
        .addItem(InvoiceCreateParams.Item.CustomItem.builder()
            .description("description")
            .taxCategory(TaxCategory.DIGITAL_PRODUCTS)
            .unitAmount(0)
            .build())
        .build()
    val invoice: Invoice = client.invoices().create(params)
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

invoice = dodo_payments.invoices.create(
  collection_method: :auto_charge,
  currency: :AED,
  customer_id: "customer_id",
  items: [{description: "description", kind: :custom, tax_category: :digital_products, unit_amount: 0}]
)

puts(invoice)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;
use Dodopayments\Invoices\CollectionMethod;
use Dodopayments\Misc\Currency;
use Dodopayments\Misc\TaxCategory;
use Dodopayments\Misc\CountryCode;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $invoice = $client->invoices->create(
    collectionMethod: CollectionMethod::AUTO_CHARGE,
    currency: Currency::AED,
    customerID: 'customer_id',
    items: [
      [
        'description' => 'description',
        'kind' => 'custom',
        'taxCategory' => TaxCategory::DIGITAL_PRODUCTS,
        'unitAmount' => 0,
        'quantity' => 0,
      ],
    ],
    billingAddress: [
      'country' => CountryCode::AF,
      'city' => 'city',
      'state' => 'state',
      'street' => 'street',
      'zipcode' => 'zipcode',
    ],
    ccEmails: ['string'],
    customerEmail: 'customer_email',
    discountIDs: ['string'],
    dueAt: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
    dunning: ['remindersEnabled' => true, 'offsetsDays' => [0]],
    memo: 'memo',
    metadata: ['foo' => 'string'],
    paymentTerms: ['type' => 'due_on_receipt'],
    reviewRequired: true,
    taxID: 'tax_id',
    idempotencyKey: 'Idempotency-Key',
  );

  var_dump($invoice);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Invoices;
using DodoPayments.Client.Models.Misc;

DodoPaymentsClient client = new();

InvoiceCreateParams parameters = new()
{
    CollectionMethod = InvoiceCollectionMethod.AutoCharge,
    Currency = Currency.Aed,
    CustomerID = "customer_id",
    Items =
    [
        new CustomItem()
        {
            Description = "description",
            TaxCategory = TaxCategory.DigitalProducts,
            UnitAmount = 0,
            Quantity = 0,
        },
    ],
};

var invoice = await client.Invoices.Create(parameters);

Console.WriteLine(invoice);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let result = client
        .invoices()
        .create()
        .body(dodopayments::models::InvoicesCreateParams {
                collection_method: Some(Box::new(dodopayments::models::CollectionMethod::AutoCharge)),
                currency: Some(Box::new(dodopayments::models::Currency::Aed)),
                customer_id: Some("customer_id".to_string()),
                items: Some(vec![serde_json::json!({"description":"description","kind":"custom","tax_category":"digital_products","unit_amount":0})]),
                ..Default::default()
            })
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request POST \
  --url https://test.dodopayments.com/billing/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "<string>",
  "items": [
    {
      "description": "<string>",
      "kind": "custom",
      "unit_amount": 123,
      "quantity": 1
    }
  ],
  "billing_address": {
    "city": "<string>",
    "state": "<string>",
    "street": "<string>",
    "zipcode": "<string>"
  },
  "cc_emails": [
    "<string>"
  ],
  "customer_email": "<string>",
  "discount_ids": [
    "<string>"
  ],
  "due_at": "2023-11-07T05:31:56Z",
  "dunning": {
    "reminders_enabled": true,
    "offsets_days": [
      123
    ]
  },
  "memo": "<string>",
  "metadata": {},
  "payment_terms": {
    "type": "due_on_receipt"
  },
  "review_required": true,
  "tax_id": "<string>"
}
'

{
  "allowed_actions": [
    "edit"
  ],
  "amount_due": 123,
  "amount_paid": 123,
  "amount_refunded": 123,
  "billing_mode": "normal",
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "credits": 123,
  "currency": "AED",
  "customer": {
    "billing_address": {
      "city": "<string>",
      "country": "AF",
      "state": "<string>",
      "street": "<string>",
      "zipcode": "<string>"
    },
    "cc_emails": [
      "<string>"
    ],
    "customer_id": "<string>",
    "email": "<string>",
    "tax_id": "<string>"
  },
  "discount_ids": [
    "<string>"
  ],
  "editable_fields": [
    "customer"
  ],
  "frequency": {
    "type": "one_time"
  },
  "invoice_id": "<string>",
  "metadata": {},
  "refund_ids": [
    "<string>"
  ],
  "retry_count": 123,
  "row_version": 123,
  "status": "open",
  "subscription_ids": [
    "<string>"
  ],
  "tags": [
    "refunded"
  ],
  "tax": 123,
  "total_amount": 123,
  "collection_method": "auto_charge",
  "due_at": "2023-11-07T05:31:56Z",
  "dunning_state": "not_started",
  "finalized_at": "2023-11-07T05:31:56Z",
  "hosted_url": "<string>",
  "lines": [
    {
      "amount": 123,
      "kind": "subscription",
      "quantity": 123,
      "tax": 123,
      "tax_inclusive": true,
      "unit_amount": 123,
      "addon_id": "<string>",
      "description": "<string>",
      "name": "<string>",
      "period_end": "2023-11-07T05:31:56Z",
      "period_start": "2023-11-07T05:31:56Z",
      "product_id": "<string>",
      "subscription_id": "<string>",
      "tax_rate": 123
    }
  ],
  "memo": "<string>",
  "next_reminder_at": "2023-11-07T05:31:56Z",
  "next_retry_at": "2023-11-07T05:31:56Z",
  "payment_terms_days": 123,
  "payments": [
    {
      "amount": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "payment_id": "<string>",
      "retry_attempt": 123,
      "status": "succeeded"
    }
  ],
  "pdf_url": "<string>",
  "reminder_settings": {
    "kind": "snapshot",
    "offsets_minutes": [
      123
    ],
    "paused": true,
    "reminders_enabled": true
  },
  "review_deadline": "2023-11-07T05:31:56Z",
  "sent_at": "2023-11-07T05:31:56Z"
}