Creates payment method shares (bulk). Beta

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developer.pace.cloud/doc/payment/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"Payment MCP server": {
  "url": "https://developer.pace.cloud/doc/payment/mcp"
}
Close
POST /2026-2/payment-methods/{paymentMethodId}/shares
Oauth2 Oauth2

Creates one share per user in the request. Maximum 50 users per request. Can be called multiple times to add more users; existing shares for the same user are updated.

Path parameters

  • paymentMethodId string(uuid) Required

    The ID of the payment method to share.

application/json

Body Required

  • expiresAt string(date-time)

    The date and time when all created shares expire. Omit for no expiration.

  • userIds array[string(uuid)] Required

    The IDs of the users to share the payment method with.

    At least 1 but not more than 50 elements.

Responses

  • 201 application/json

    The created payment method shares.

    Hide response attribute Show response attribute object
    • data array[object] Required

      A list of payment method shares.

      Hide data attributes Show data attributes object
      • createdAt string(date-time) Required

        The date and time when the payment method share was created.

      • expiresAt string(date-time) | null Required

        The date and time when the share expires. After this time the share is no longer valid. Omit for no expiration.

      • id string(uuid) Required

        The unique identifier of the payment method share.

      • paymentMethodId string(uuid) Required

        The unique identifier of the payment method that was shared.

      • updatedAt string(date-time) Required

        The date and time when the payment method share was last updated.

      • userId string(uuid) Required

        The unique identifier of the user the payment method is shared with.
  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The payment method was not found.

  • 500

    An internal server error occurred.

POST /2026-2/payment-methods/{paymentMethodId}/shares 
curl \
 --request POST 'https://api.pace.cloud/payment/2026-2/payment-methods/9ff485e6-b028-420e-91cb-4438e335d964/shares' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"expiresAt":"2025-12-31T23:59:59.000Z","userIds":["263ca0fd-60a4-4369-80d6-52f55e9617c8","b0c2b734-7ec7-4404-a7bb-a0262c80c81c"]}'
Request examples 
{
  "expiresAt": "2025-12-31T23:59:59.000Z",
  "userIds": [
    "263ca0fd-60a4-4369-80d6-52f55e9617c8",
    "b0c2b734-7ec7-4404-a7bb-a0262c80c81c"
  ]
}
Response examples (201) 
{
  "data": [
    {
      "createdAt": "2023-10-01T12:00:00.000Z",
      "expiresAt": "2025-12-31T23:59:59.000Z",
      "id": "92e5ec38-2a2c-4040-8158-f053b1f45054",
      "paymentMethodId": "45981481-b14d-4075-a8bc-d9626979a3ba",
      "updatedAt": "2023-10-01T12:00:00.000Z",
      "userId": "9d38dbaa-3f65-4453-b6f3-53673bd1a413"
    }
  ]
}