v1

latestOpenAPI 3.1.02026-07-132363652.9 MB

Transactions

Update billing address for a transaction

put/api/v1/merchants/{merchantId}/transactions/{transactionId}/billing-address

Path parameters

merchantIdstring uuid required

The unique identifier of the merchant

Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the merchant

transactionIdstring uuid required

The unique identifier of the transaction

Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the transaction

Request body

Example request

{
  "billing_address": {
    "address_line1": "12 West Common Drive",
    "address_line2": "Flat 1",
    "apartment": "Apt 5B",
    "city": "London",
    "state_province": "Greater London",
    "country": "GB",
    "postal_code": "SE1 1AA",
    "company_name": "Acme Ltd"
  }
}

Response

Success

successboolean required

Example response

{
  "data": {
    "currency": {
      "code": "GBP",
      "symbol": "€",
      "name": "Euro",
      "minor_unit": 2
    },
    "payout_currency": {
      "code": "GBP",
      "symbol": "€",
      "name": "Euro",
      "minor_unit": 2
    },
    "payment_request": {
      "order_id": "ORD-2025-00123",
      "payment_token": "tok_abc123def456"
    },
    "merchant_webhook_deliveries": [
      {
        "event_type": "quidkey.payment_request.succeeded"
      }
    ],
    "fees": {
      "currency": {
        "code": "GBP",
        "symbol": "€",
        "name": "Euro",
        "minor_unit": 2
      },
      "items": [
        {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          }
        }
      ]
    },
    "refunds": [
      {
        "currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payout_currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payment_request": {
          "order_id": "ORD-2025-00123",
          "payment_token": "tok_abc123def456"
        },
        "merchant_webhook_deliveries": [
          {
            "event_type": "quidkey.payment_request.succeeded"
          }
        ],
        "fees": {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "items": [
            {
              "currency": {
                "code": "GBP",
                "symbol": "€",
                "name": "Euro",
                "minor_unit": 2
              }
            }
          ]
        }
      }
    ],
    "reversals": [
      {
        "currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payout_currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payment_request": {
          "order_id": "ORD-2025-00123",
          "payment_token": "tok_abc123def456"
        },
        "merchant_webhook_deliveries": [
          {
            "event_type": "quidkey.payment_request.succeeded"
          }
        ],
        "fees": {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "items": [
            {
              "currency": {
                "code": "GBP",
                "symbol": "€",
                "name": "Euro",
                "minor_unit": 2
              }
            }
          ]
        }
      }
    ]
  }
}