---
title: "Creates new payment for a given product"
method: POST
path: "/v1/api/products/{productExternalId}/payments"
tags: ["Payments"]
---

# Creates new payment for a given product

`POST /v1/api/products/{productExternalId}/payments`

## Request

- Base URL: `http://products_url`
- URL: `http://products_url/v1/api/products/{productExternalId}/payments`
- Auth: none declared

## Path parameters

- `productExternalId` string, required

## Request body

- object
  - `price` number: Price override for the payment amount. If not present this will defaults to price of product.

## Response `201`

OK

- Payment
  - `_links` Link[], required
    - `href` string
    - `method` string
    - `rel` 'self' | 'pay' | 'next' | 'friendly'
  - `amount` integer, required
  - `external_id` string, required
  - `govuk_payment_id` string
  - `govuk_status` string
  - `product_external_id` string, required
  - `reference_number` string
  - `status` 'CREATED' | 'SUBMITTED' | 'ERROR', required

## Other responses

- `400`: For invalid payload

## Changes

- **2022-04-05** `9ffbc14fb6d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/government-digital-service/apis/products-api/changes/v1/api/products/:productExternalId/payments/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/products-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/products-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/products-api/revisions/521f70c3f2d9?raw)