Test helpers for stubbing Stripe HTTP requests.

Uses ownership-based stubs (via NimbleOwnership) so stubs are scoped to the test process and work correctly with async: true tests.

Setup

In your test/test_helper.exs:

Stripe.Test.start()
ExUnit.start()

Stubbing Requests

test "creates a charge" do
  Stripe.Test.stub(fn %{method: :post, url: url} ->
    assert url =~ "/v1/charges"
    {200, [], ~s({"id": "ch_123", "object": "charge"})}
  end)

  client = Stripe.Test.client("sk_test_123")

  {:ok, data} =
    Stripe.Client.request(client, :post, "/v1/charges",
      params: %{amount: 2000, currency: "usd"}
    )

  assert data["id"] == "ch_123"
end

Async Tests

Stripe.Test.client/2 captures the calling test process in the client's transport, so spawned processes can use that client:

test "works from a spawned task" do
  Stripe.Test.stub(fn _req -> {200, [], ~s({"ok": true})} end)
  client = Stripe.Test.client("sk_test_123")

  Task.async(fn ->
    Stripe.Client.request(client, :get, "/v1/balance")
  end)
  |> Task.await()
end

Stub Function

The stub function receives a map with:

• :method - HTTP method atom (:get, :post, etc.)
• :url - Full URL string
• :headers - List of {name, value} tuples
• :body - Request body (string or nil)

And must return a {status, headers, body} tuple:

• status - HTTP status code (integer)
• headers - Response headers as [{name, value}]
• body - Response body (string)