---
title: "Update payment expiry"
method: PUT
path: "/config/payments/payment_expiries/{payment_expiry_id}"
tags: ["Payment expiration"]
---

# Update payment expiry

`PUT /config/payments/payment_expiries/{payment_expiry_id}`

## Request

- Base URL: `//[domainPrefix].ripplexcurrent.com/v4` (relative, and it does not resolve against the document’s source URL)
- URL: `//[domainPrefix].ripplexcurrent.com/v4/config/payments/payment_expiries/{payment_expiry_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ripple/apis/ripplenet-server-api/docs/config/payments/payment_expiries/:payment_expiry_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the time to live (ttl) of a payment expiry in seconds.

## Path parameters

- `payment_expiry_id` string, uuid, required

## Request body

- PaymentExpiry: Use this JSON request object to update the payment time to live represented in seconds.
  - `payment_ttl` number: Payment expiration window, or time to live (ttl), in seconds. To calculate the payment expiration date, xCurrent adds this value to the payment creation timestamp.
  - `sending_partner` string: RippleNet address of the sender, in the format `ripplenetaddress`. For example, `rn.us.sf.san_francisco`.
  - `receiving_partner` string: RippleNet address of the receiver, in the format `ripplenetaddress`. For example, `rn.us.ny.new_york`.
  - `currency` string: currency of the exchange rate.

## Response `200`

Successfully updated payment expiry.

- PaymentExpiryResponse: Use this JSON request object to update the payment time to live represented in seconds.
  - `payment_ttl` number: Payment expiration window, or time to live (ttl), in seconds. To calculate the payment expiration date, xCurrent adds this value to the payment creation timestamp.
  - `sending_partner` string: RippleNet address of the sender, in the format `ripplenetaddress`. For example, `rn.us.sf.san_francisco`.
  - `receiving_partner` string: RippleNet address of the receiver, in the format `ripplenetaddress`. For example, `rn.us.ny.new_york`.
  - `currency` string: currency of the exchange rate.
  - `expiry_id` string, uuid: id of payment expiry object

## Other responses

- `400`: Bad request.

---

[API](https://skmtc.dev/ripple/apis/ripplenet-server-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripplenet-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripplenet-server-api/revisions/7843f07ca150?raw)