# `X402.PaymentResponse`
[🔗](https://github.com/cardotrejos/x402/blob/main/lib/x402/payment_response.ex#L1)

Encodes and decodes the x402 `PAYMENT-RESPONSE` header value.

The header is Base64-encoded JSON and is typically returned by a server after
settlement.

# `decode`
*since 0.1.0* 

```elixir
@spec decode(String.t()) :: {:ok, map()} | {:error, decode_error()}
```

Decodes a Base64 `PAYMENT-RESPONSE` value to a map.

Returns `{:error, :payload_too_large}` when the encoded value exceeds 8 KB.
Returns `{:error, :invalid_base64}` when the value cannot be Base64-decoded.
Returns `{:error, :invalid_json}` when JSON cannot be decoded to a map.

## Examples

    iex> {:ok, value} = X402.PaymentResponse.encode(%{"settled" => true})
    iex> X402.PaymentResponse.decode(value)
    {:ok, %{"settled" => true}}

    iex> X402.PaymentResponse.decode("%%%")
    {:error, :invalid_base64}

# `encode`
*since 0.1.0* 

```elixir
@spec encode(map()) :: {:ok, String.t()} | {:error, encode_error()}
```

Encodes a settlement response payload to a Base64 header value.

## Examples

    iex> {:ok, value} = X402.PaymentResponse.encode(%{"settled" => true})
    iex> X402.PaymentResponse.decode(value)
    {:ok, %{"settled" => true}}

# `header_name`
*since 0.1.0* 

```elixir
@spec header_name() :: String.t()
```

Returns the canonical x402 header name.

## Examples

    iex> X402.PaymentResponse.header_name()
    "PAYMENT-RESPONSE"

# `decode_error`

```elixir
@type decode_error() :: :invalid_base64 | :invalid_json | :payload_too_large
```

# `encode_error`

```elixir
@type encode_error() :: :invalid_payload | :invalid_json
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*