---
title: "update an instance of payments with different phases of payment flows."
method: POST
path: "/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Payments/{Sid}.json"
tags: ["Api20100401Payment"]
---

# update an instance of payments with different phases of payment flows.

`POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Payments/{Sid}.json`

## Request

- Base URL: `https://api.twilio.com`
- URL: `https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Payments/{Sid}.json`
- Auth: HTTP basic

update an instance of payments with different phases of payment flows.

## Path parameters

- `AccountSid` string, required
- `CallSid` string, required
- `Sid` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `IdempotencyKey` string, required: A unique token that will be used to ensure that multiple API calls with the same information do not result in multiple transactions. This should be a unique string value per API call and can be a randomly generated.
  - `StatusCallback` string, uri, required: Provide an absolute or relative URL to receive status updates regarding your Pay session. Read more about the [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
  - `Capture` 'payment-card-number' | 'expiration-date' | 'security-code' | 'postal-code' | 'bank-routing-number' | 'bank-account-number' | 'payment-card-number-matcher' | 'expiration-date-matcher' | 'security-code-matcher' | 'postal-code-matcher': The piece of payment information that you wish the caller to enter. Must be one of `payment-card-number`, `expiration-date`, `security-code`, `postal-code`, `bank-routing-number`, `bank-account-number`, or their `-matcher` variants for input confirmation when `RequireMatchingInputs` is enabled.
  - `Status` 'complete' | 'cancel': Indicates whether the current payment session should be cancelled or completed. When `cancel` the payment session is cancelled. When `complete`, Twilio sends the payment information to the selected Pay Connector for processing.

## Response `202`

Accepted

- ApiV2010AccountCallPayments
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Payments resource.
  - `call_sid` string, nullable: The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Payments resource is associated with. This will refer to the call sid that is producing the payment card (credit/ACH) information thru DTMF.
  - `sid` string, nullable: The SID of the Payments resource.
  - `date_created` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `uri` string, nullable: The URI of the resource, relative to `https://api.twilio.com`.

## Changes

- **2026-03-10** (v2010) `a922c3aef8aa`: 4 info
  - added the new `expiration-date-matcher` enum value to the request property `Capture`
  - added the new `payment-card-number-matcher` enum value to the request property `Capture`
  - added the new `postal-code-matcher` enum value to the request property `Capture`
  - added the new `security-code-matcher` enum value to the request property `Capture`

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/Calls/:CallSid/Payments/:Sid.json/post.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) - [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/bfdf249a1298?raw)