Capture a payment

Request a payment capture during a workflow execution.

Path Params
string
required

Path parameter to specify the workflow code.

uuid
required

Identifier of the resource in Payrails.

Body Params
amount
object

The amount to capture, including currency. Full amount will be captured if not specified.

string
enum

Reason for invoking the operation or action.

string

An optional field to include any necessary information for the capture action.

meta
object

Metadata for the context of an execution. Includes Payrails-defined structures for most common fields used in workflows, but can also be extended by merchant or provider-specific fields. For more information, visit our Meta Fields guide.

boolean

The final parameter indicates if multiple partial captures are expected, if the value is false and the captured amount is less than the authorized amount then multiple partial captures can be applied until reaching the original authorized amount, if the value is true or the parameter is not sent the capture will be treated as a final capture and no further capture request will be accepted for it.

Headers
uuid
required

Idempotency key to be used. Sending again the same key would return the same result without re-executing the update.

Responses

Language
Credentials
Bearer
JWT
Response
Choose an example:
application/json