Capture a Payment

POST/api/payments/{identifier}/capture

This endpoint captures a payment that was previously authorized. It finalizes the transaction by moving funds from the customer to the merchant.

Path Parameters

identifierstringrequired

Response

A successful response indicating that the payment has been captured.

resultobject

The result of the capture request, including status and any relevant messages.

Show result properties

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

merchantIdentifierstring

The unique identifier for the merchant associated with the payment.

paymentIdentifierstring

The unique identifier for the captured payment.

amountnumber<double>

The amount that was captured.

currencyCodestring

The three-letter currency code (ISO 4217) for the payment.

paymentStatus"New" | "Authorized" | "Captured" | "Voided" | "Processing"

The current status of the payment after capture.

acquirerstring

The name of the acquirer processing the payment.

customerIdentifierstring

The unique identifier for the customer associated with the payment.

customerReferencestring

A reference provided by the merchant to identify the customer.

merchantOrderIdstring

The unique identifier for the merchant's order.

paymentMethodIdentifierstring

The unique identifier for the payment method used.

The request is invalid or contains incorrect parameters.

resultobject

The result object that contains the outcome and additional details of the API request.

Show result properties

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

Unauthorized request. Authentication is required.

Access is forbidden due to insufficient permissions.

The specified payment was not found.

resultobject

The result object that contains the outcome and additional details of the API request.

Show result properties

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://testapi.linksmerchantservices.com/api/payments/<identifier>/capture"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("POST", "https://testapi.linksmerchantservices.com/api/payments/<identifier>/capture", nil) resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://testapi.linksmerchantservices.com/api/payments/<identifier>/capture")) .method("POST", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://testapi.linksmerchantservices.com/api/payments/<identifier>/capture") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) response = http.request(request) puts response.body

{ "result": { "resultType": "Accepted", "merchantMessage": "string", "logIdentifier": "string", "logAsError": true }, "merchantIdentifier": "string", "paymentIdentifier": "string", "amount": 0, "currencyCode": "string", "paymentStatus": "New", "acquirer": "string", "customerIdentifier": "string", "customerReference": "string", "merchantOrderId": "string", "paymentMethodIdentifier": "string" }