> ## Documentation Index
> Fetch the complete documentation index at: https://docs-alpha.pepay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit form

> Submit payor form data for a session.

## Overview

Submit responses to invoice questions (if the invoice was configured with custom questions). Use this after fetching the schema via [Invoice questions](/api-spec/payors/invoice-questions).

## Authentication

Requires:

* `x-session-token: pst_...`
* `x-signature: sig_...`

## Request

Endpoint:

* `POST /api/v1/payments/submit-form`

Example:

```bash theme={null}
BASE_URL=${PEPAY_API_URL}

curl -X POST "$BASE_URL/api/v1/payments/submit-form" \
  -H "x-session-token: pst_..." \
  -H "x-signature: sig_..." \
  -H "Content-Type: application/json" \
  -d '{
    "responses":[
      { "question_id":"q1", "response":"customer@example.com" }
    ]
  }'
```

## Response

```json theme={null}
{
  "success": true
}
```

## Errors

* `401` invalid session token/signature
* `400` invalid responses payload (missing required question ids, wrong types)

## Examples

* After submitting, continue the checkout by selecting a token and creating a [Payment address](/api-spec/payors/payment-addresses).

Next: [WS token](/api-spec/realtime/ws-token)