Endpoints to manage account members. Members are users that have membership within merchant accounts.
Beta.
Objects:
- List membersGET
/v0.1/merchants/{merchant_code}/membersLists merchant members.
OAuth scopes: Requires one of:
user.subaccounts,members.read.Required permissions:
{"relation":"merchant_read","object_type":"merchant","object_id_param":"merchant_code"}
- Create a memberPOST
/v0.1/merchants/{merchant_code}/membersAdds a member to the merchant account with the specified roles.
By default, sends an invitation email to the provided address. The recipient must accept the invitation to join the account. When
is_managed_useristrue, creates a managed user with the provided password and optional nickname and assigns the roles directly, without sending an invitation.OAuth scopes: Requires one of:
user.subaccounts,members.write.Required permissions:
{"relation":"members_create","object_type":"merchant","object_id_param":"merchant_code"}
- Retrieve a memberGET
/v0.1/merchants/{merchant_code}/members/{member_id}Retrieve a merchant member.
OAuth scopes: Requires one of:
user.subaccounts,members.read.Required permissions:
{"relation":"members_view","object_type":"merchant","object_id_param":"merchant_code"}
- Update a memberPUT
/v0.1/merchants/{merchant_code}/members/{member_id}Updates a merchant member and returns the updated member.
Providing
rolesreplaces the member's assigned roles and can grant or revoke access. Providingmetadatareplaces the entire metadata object. For managed users,user.nicknamechanges the display name anduser.passwordreplaces the password. Updating the password also enables the managed user account.OAuth scopes: Requires one of:
user.subaccounts,members.write.Required permissions:
{"relation":"members_update","object_type":"merchant","object_id_param":"merchant_code"}
- Delete a memberDELETE
/v0.1/merchants/{merchant_code}/members/{member_id}Deletes a merchant member.
OAuth scopes: Requires one of:
user.subaccounts,members.write.Required permissions:
{"relation":"members_delete","object_type":"merchant","object_id_param":"merchant_code"}