The createMember API call is used to create a free or paid member on your membership site. It can also be used to change an existing member’s membership level. If the email address passed is associated with an existing member and the membership level ID passed is different than the one associated with their account, then MemberMouse will change their membership level and automatically cancel any active subscriptions associated with the current membership.
IMPORTANTE: Se você optar por passar dados brutos de cartão de crédito usando essa chamada de API, estará exposto a um nível mais alto de requisitos SAQ de conformidade com a PCI (SAQ-D). É sua responsabilidade garantir que esteja em conformidade.
Exemplo de URL de solicitação
http://{Your_API_URL}?q=/createMember
Parâmetros de entrada
| Parâmetro | Descrição | Necessário |
apikey | Chave de API de Credenciais da API do MemberMouse | Sim |
apisecret | Segredo da API de Credenciais da API do MemberMouse | Sim |
membership_level_id | Membership level ID to assign to the new member’s account | Sim |
product_id | Each paid membership level you create in MemberMouse will have a default product associated with it. If this field is left blank then the default product will be used to place the order. You can optionally pass a valid product ID that’s associated with the membership level here to charge a different price for the membership level then the default product. | Não |
e-mail | Endereço de e-mail do novo membro | Sim |
nome de usuário | Username for the new member. If this is not provided the member’s email address will be used as their username. | Não |
primeiro_nome | Primeiro nome do novo membro | Não |
sobrenome | Sobrenome do novo membro | Não |
senha | A senha que você deseja definir para o novo membro. Se ela não for fornecida, o MemberMouse gerará automaticamente uma senha para o novo membro. | Não |
telefone | Número de telefone do novo membro | Não |
endereço de cobrança | endereço de cobrança do novo membro | Condicional (Não se o nível de associação for gratuito) |
cidade_de_faturamento | cidade de cobrança do novo membro. | Condicional (Não se o nível de associação for gratuito) |
billing_state | estado de cobrança do novo membro | Condicional (Não se o nível de associação for gratuito) |
billing_zip | código postal de cobrança do novo membro | Condicional (Não se o nível de associação for gratuito) |
país_de_faturamento | país de faturamento do novo membro (Código de país ISO de 2 dígitos) | Condicional (Não se o nível de associação for gratuito) |
número_de_crédito | New member’s credit card number | Condicional (Não se o nível de associação for gratuito) |
exp_month | Expiration month of the new member’s credit card (2 digits) | Condicional (Não se o nível de associação for gratuito) |
ano_exp | Expiration year of the new member’s credit card (4 digits) | Condicional (Não se o nível de associação for gratuito) |
código_de_segurança | Security code (CVV) of the new member’s credit card | Condicional (Não se o nível de associação for gratuito) |
shipping_same_as_billing | Isso pode ser definido como SIM ou NÃO. Se for definido como YES, você não precisará fornecer informações sobre o endereço de entrega. NO é o valor padrão. | Condicional (Não se o nível de associação for gratuito) |
shipping_method | Código do método de envio do método de envio que você deseja aplicar ao pedido. Você pode encontrar códigos de métodos de envio na tela de métodos de envio no MemberMouse. | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
endereço_de_envio | endereço de entrega do novo membro | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
cidade_de_envio | cidade de embarque do novo membro | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
shipping_state | estado de envio do novo membro | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
CEP de remessa | CEP de envio do novo membro | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
país_de_envio | país de expedição do novo membro (Código de país ISO de 2 dígitos) | Condicional (Não se o nível de associação for gratuito ou se o endereço de entrega for o mesmo que o endereço de cobrança) |
affiliate_id | ID de afiliado a ser criado com o pedido | Não |
sub_affiliate_id | ID da sub-afiliada para creditar no pedido | Não |
código do cupom | Código de cupom válido que você deseja aplicar ao pedido | Não |
campo_personalizado_[ID#] | Você pode passar dados de campo personalizado para a API passando um ou mais parâmetros no formulário custom_field_[ID#], em que [ID#] seria substituído pela ID do campo personalizado, conforme definido no MemberMouse. Por exemplo, se o ID do campo personalizado for 4, você passaria os dados desse campo personalizado incluindo o parâmetro custom_field_4. | Não |
Códigos de resposta
- 200 - Sucesso
- 409 - Não foi possível criar um novo membro
Dados de resposta
| Parâmetro | Descrição |
member_id | A ID do novo membro no MemberMouse |
e-mail | The new member’s email |
nome de usuário | The new member’s username |
senha | The new member’s password |
confirmationUrl | O URL da página de confirmação associada à compra. Ele tem uma chave de transação anexada a ele para que o MemberMouse SmartTags™ funcione nessa página de confirmação. |

