Report informational updates on the specified Payment Record.
Parameters
- idstringRequired
The ID of the Payment Record.
- customer_
detailsobject Customer information for this payment.
- customer_details.
customerstring The customer who made the payment.
- customer_details.
emailstring The customer’s phone number.
- customer_details.
namestring The customer’s name.
- customer_details.
phonestring The customer’s phone number.
- descriptionstring
An arbitrary string attached to the object. Often useful for displaying to users.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - shipping_
detailsobject Shipping information for this payment.
- shipping_details.
addressobject The physical shipping address.
- shipping_details.
address. citystring City, district, suburb, town, or village.
- shipping_details.
address. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- shipping_details.
address. line1string Address line 1, such as the street, PO Box, or company name.
- shipping_details.
address. line2string Address line 2, such as the apartment, suite, unit, or building.
- shipping_details.
address. postal_ codestring ZIP or postal code.
- shipping_details.
address. statestring State, county, province, or region.
- shipping_details.
namestring The shipping recipient’s name.
- shipping_details.
phonestring The shipping recipient’s phone number.
Returns
The updated Payment Record object.
{ "id": "pr_5RV730PrHyAEi", "object": "payment_record", "amount_canceled": { "currency": "usd", "value": 0 }, "amount_failed": { "currency": "usd", "value": 0 }, "amount_guaranteed": { "currency": "usd", "value": 0 }, "amount_refunded": { "currency": "usd", "value": 0 }, "amount_requested": { "currency": "usd", "value": 1000 }, "created": 1730211363, "customer_details": { "name": "Jenny Rosen", "email": "jenny.rosen@example.com", "phone": "+15551234567" }, "customer_presence": "on_session", "description": "Updated payment description with additional context", "latest_payment_attempt_record": "par_1ArV730PrHyQuG", "livemode": true, "metadata": { "order_id": "order_12345", "updated_by": "customer_service", "update_reason": "customer_inquiry" }, "payment_method_details": { "billing_details": null, "custom": { "display_name": "newpay", "type": "cpmt_125kjj3hn3sdf" }, "payment_method": "pm_5j23kjksibjlks", "type": "custom" }, "processor_details": { "type": "custom", "custom": { "payment_reference": "npp2358872734k" } }, "shipping_details": { "name": "Jenny Rosen", "address": { "line1": "123 Main Street", "line2": "Apt 4B", "city": "San Francisco", "state": "CA", "postal_code": "94111", "country": "US" } }}