Update a Payment Method

POST/api/paymentmethod/update

This endpoint allows updating an existing payment method by providing the necessary details such as payment method type, card information, and billing details. The `merchantIdentifier` and `paymentMethodIdentifier` are required to locate the payment method to update.

Body application/json

paymentMethodTypestring

The type of payment method, such as credit card or other forms of payment.

cardobject

The credit card details associated with the payment method, if applicable.

Show card properties

cardNumberstring

The credit card number. This field is optional and should be stored securely.

expiryMonthinteger<int32>

The expiry month of the credit card.

expiryYearinteger<int32>

The expiry year of the credit card.

cardHolderNamestring

The name of the cardholder as it appears on the credit card.

cvvstring

The card verification value (CVV) for the credit card. This field is optional.

The brand of the credit card, such as Visa or MasterCard.

billingInformationobject

Billing address and contact information for the payment method.

Show billingInformation properties

firstLinestring

The first line of the billing address.

secondLinestring

The second line of the billing address.

citystring

The city of the billing address.

regionstring

The region or state of the billing address.

zipCodestring

The postal or ZIP code of the billing address.

countryAlpha3Codestring

The three-letter country code (ISO Alpha-3) for the billing address.

countryIdinteger<int64>

The unique identifier for the country.

merchantIdentifierstringrequired

A unique identifier for the merchant associated with the payment method.

paymentMethodIdentifierstringrequired

A unique identifier for the payment method to be updated.

Response

A successful response containing the updated payment method details.

resultobject

The result of the payment method retrieval request, including the 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 this payment method.

customerIdentifierstring

The unique identifier for the customer, if available.

customerReferencestring

A reference provided by the merchant to identify the customer associated with the payment method.

paymentMethodIdentifierstring

The unique identifier for the payment method.

cardobject

The details of the credit card associated with this payment method.

Show card properties

cardNumberstring

The credit card number. This field is optional and should be stored securely.

expiryMonthinteger<int32>

The expiry month of the credit card.

expiryYearinteger<int32>

The expiry year of the credit card.

cardHolderNamestring

The name of the cardholder as it appears on the credit card.

cvvstring

The card verification value (CVV) for the credit card. This field is optional.

The brand of the credit card, such as Visa or MasterCard.

billingInformationobject

The billing information associated with the payment method, including address details.

Show billingInformation properties

firstLinestring

The first line of the billing address.

secondLinestring

The second line of the billing address.

citystring

The city of the billing address.

regionstring

The region or state of the billing address.

zipCodestring

The postal or ZIP code of the billing address.

countryAlpha3Codestring

The three-letter country code (ISO Alpha-3) for the billing address.

countryIdinteger<int64>

The unique identifier for the country.

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.

The specified payment method 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.

curl -X POST "https://testapi.linksmerchantservices.com/api/paymentmethod/update" \ -H "Content-Type: application/json" \ -d '{ "paymentMethodType": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 }, "merchantIdentifier": "string", "paymentMethodIdentifier": "string" }'

const response = await fetch(`https://testapi.linksmerchantservices.com/api/paymentmethod/update`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ "paymentMethodType": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 }, "merchantIdentifier": "string", "paymentMethodIdentifier": "string" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://testapi.linksmerchantservices.com/api/paymentmethod/update", json={ "paymentMethodType": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 }, "merchantIdentifier": "string", "paymentMethodIdentifier": "string" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://testapi.linksmerchantservices.com/api/paymentmethod/update"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "paymentMethodType": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 }, "merchantIdentifier": "string", "paymentMethodIdentifier": "string" }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://testapi.linksmerchantservices.com/api/paymentmethod/update", strings.NewReader(`{ "paymentMethodType": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 }, "merchantIdentifier": "string", "paymentMethodIdentifier": "string" }`)) req.Header.Set("Content-Type", "application/json") 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/paymentmethod/update")) .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"paymentMethodType\": \"string\",\n \"card\": {\n \"cardNumber\": \"string\",\n \"expiryMonth\": 0,\n \"expiryYear\": 0,\n \"cardHolderName\": \"string\",\n \"cvv\": \"string\",\n \"creditCardBrand\": \"Unknown\"\n },\n \"billingInformation\": {\n \"firstLine\": \"string\",\n \"secondLine\": \"string\",\n \"city\": \"string\",\n \"region\": \"string\",\n \"zipCode\": \"string\",\n \"countryAlpha3Code\": \"string\",\n \"countryId\": 0\n },\n \"merchantIdentifier\": \"string\",\n \"paymentMethodIdentifier\": \"string\"\n}")) .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/paymentmethod/update") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request.body = "{\n \"paymentMethodType\": \"string\",\n \"card\": {\n \"cardNumber\": \"string\",\n \"expiryMonth\": 0,\n \"expiryYear\": 0,\n \"cardHolderName\": \"string\",\n \"cvv\": \"string\",\n \"creditCardBrand\": \"Unknown\"\n },\n \"billingInformation\": {\n \"firstLine\": \"string\",\n \"secondLine\": \"string\",\n \"city\": \"string\",\n \"region\": \"string\",\n \"zipCode\": \"string\",\n \"countryAlpha3Code\": \"string\",\n \"countryId\": 0\n },\n \"merchantIdentifier\": \"string\",\n \"paymentMethodIdentifier\": \"string\"\n}" response = http.request(request) puts response.body

{ "result": { "resultType": "Accepted", "merchantMessage": "string", "logIdentifier": "string", "logAsError": true }, "merchantIdentifier": "string", "customerIdentifier": "string", "customerReference": "string", "paymentMethodIdentifier": "string", "card": { "cardNumber": "string", "expiryMonth": 0, "expiryYear": 0, "cardHolderName": "string", "cvv": "string", "creditCardBrand": "Unknown" }, "billingInformation": { "firstLine": "string", "secondLine": "string", "city": "string", "region": "string", "zipCode": "string", "countryAlpha3Code": "string", "countryId": 0 } }