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"
    }
  ]
}