Skip to main content

​
Overview

Submit responses to invoice questions (if the invoice was configured with custom questions). Use this after fetching the schema via Invoice questions.

​
Authentication

Requires:
  • x-session-token: pst_...
  • x-signature: sig_...

​
Request

Endpoint:
  • POST /api/v1/payments/submit-form
Example: 
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

{
  "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.
Next: WS token