---
title: "Add/update payment session(s) details"
method: PUT
path: "/submission/{submission-id}/payment-sessions"
tags: ["payment"]
---

# Add/update payment session(s) details

`PUT /submission/{submission-id}/payment-sessions`

## Request

- Base URL: `/efs-submissions-api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/efs-submissions-api/submission/{submission-id}/payment-sessions`
- Auth: none declared

## Response `201`

Session details updated

- PaymentSession[]: Collection of associated payment session details
  - `session_id` string, required
  - `session_state` string, Base64 encoded, required: secure random nonce
  - `session_status` 'Paid' | 'Pending' | 'Failed', required: Provisional payment session status

## Other responses

- `400`: Incomplete or malformed request
- `401`: Invalid or missing credentials
- `404`: Requested resource was not found
- `409`: Request valid but not consistent with state of resource

## Changes

- **2020-10-16** `23e5c1f1c8a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/changes/submission/:submission-id/payment-sessions/put.md)

---

[API](https://skmtc.dev/companies-house/apis/emergency-filing-service-api.md) - [All operations](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/revisions/7dbd2ded46b4?raw)