{"id":8041,"date":"2023-08-14T13:49:48","date_gmt":"2023-08-14T20:49:48","guid":{"rendered":"https:\/\/membermouse.com\/?post_type=ht_kb&#038;p=8041"},"modified":"2024-09-05T11:01:56","modified_gmt":"2024-09-05T15:01:56","slug":"chamada-de-api-de-createmember","status":"publish","type":"ht_kb","link":"https:\/\/membermouse.com\/pt\/documentos-3-2\/chamada-de-api-de-createmember\/","title":{"rendered":"Chamada de API createMember"},"content":{"rendered":"<p>A chamada createMember API \u00e9 usada para criar um membro gratuito ou pago em seu site de associa\u00e7\u00e3o. Ela tamb\u00e9m pode ser usada para alterar o n\u00edvel de associa\u00e7\u00e3o de um membro existente. Se o endere\u00e7o de e-mail passado estiver associado a um membro existente e a ID do n\u00edvel de associa\u00e7\u00e3o passada for diferente da associada \u00e0 conta dele, o MemberMouse alterar\u00e1 o n\u00edvel de associa\u00e7\u00e3o e cancelar\u00e1 automaticamente todas as assinaturas ativas associadas \u00e0 associa\u00e7\u00e3o atual.<\/p>\n\n\n\n<p><strong>IMPORTANTE:<\/strong>&nbsp;Se voc\u00ea optar por passar dados brutos de cart\u00e3o de cr\u00e9dito usando essa chamada de API, estar\u00e1 exposto a um n\u00edvel mais alto de requisitos SAQ de conformidade com a PCI (SAQ-D). \u00c9 sua responsabilidade garantir que esteja em conformidade.<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Exemplo de URL de solicita\u00e7\u00e3o<\/h5>\n\n\n\n<p><code>http:\/\/{Your_API_URL}?q=\/createMember<\/code><\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Par\u00e2metros de entrada<\/h5>\n\n\n\n<div style=\"height:5px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Par\u00e2metro<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><td><strong>Necess\u00e1rio<\/strong><\/td><\/tr><tr><td><code>apikey<\/code><\/td><td>Chave de API de&nbsp;<a href=\"https:\/\/membermouse.com\/pt\/documentos-3-2\/visao-geral-das-credenciais-da-api\/\">Credenciais da API do MemberMouse<\/a><\/td><td>Sim<\/td><\/tr><tr><td><code>apisecret<\/code><\/td><td>Segredo da API de&nbsp;<a href=\"https:\/\/membermouse.com\/pt\/documentos-3-2\/visao-geral-das-credenciais-da-api\/\">Credenciais da API do MemberMouse<\/a><\/td><td>Sim<\/td><\/tr><tr><td><code>membership_level_id<\/code><\/td><td>ID do n\u00edvel de associa\u00e7\u00e3o a ser atribu\u00eddo \u00e0 conta do novo membro<\/td><td>Sim<\/td><\/tr><tr><td><code>product_id<\/code><\/td><td>Cada n\u00edvel de associa\u00e7\u00e3o paga que voc\u00ea criar no MemberMouse ter\u00e1 um produto padr\u00e3o associado a ele. Se esse campo for deixado em branco, o produto padr\u00e3o ser\u00e1 usado para fazer o pedido. Opcionalmente, voc\u00ea pode passar um ID de produto v\u00e1lido associado ao n\u00edvel de associa\u00e7\u00e3o aqui para cobrar um pre\u00e7o diferente do produto padr\u00e3o para o n\u00edvel de associa\u00e7\u00e3o.<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>e-mail<\/code><\/td><td>Endere\u00e7o de e-mail do novo membro<\/td><td>Sim<\/td><\/tr><tr><td><code>nome de usu\u00e1rio<\/code><\/td><td>Nome de usu\u00e1rio para o novo membro. Se isso n\u00e3o for fornecido, o endere\u00e7o de e-mail do membro ser\u00e1 usado como seu nome de usu\u00e1rio.<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>primeiro_nome<\/code><\/td><td>Primeiro nome do novo membro<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>sobrenome<\/code><\/td><td>Sobrenome do novo membro<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>senha<\/code><\/td><td>A senha que voc\u00ea deseja definir para o novo membro. Se ela n\u00e3o for fornecida, o MemberMouse gerar\u00e1 automaticamente uma senha para o novo membro.<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>telefone<\/code><\/td><td>N\u00famero de telefone do novo membro<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>endere\u00e7o de cobran\u00e7a<\/code><\/td><td>endere\u00e7o de cobran\u00e7a do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>cidade_de_faturamento<\/code><\/td><td>cidade de cobran\u00e7a do novo membro.<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>billing_state<\/code><\/td><td>estado de cobran\u00e7a do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>billing_zip<\/code><\/td><td>c\u00f3digo postal de cobran\u00e7a do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>pa\u00eds_de_faturamento<\/code><\/td><td>pa\u00eds de faturamento do novo membro (<a href=\"http:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Officially_assigned_code_elements\" target=\"_blank\" rel=\"noreferrer noopener\">C\u00f3digo de pa\u00eds ISO de 2 d\u00edgitos<\/a>)<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>n\u00famero_de_cr\u00e9dito<\/code><\/td><td>N\u00famero do cart\u00e3o de cr\u00e9dito do novo associado<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>exp_month<\/code><\/td><td>M\u00eas de vencimento do cart\u00e3o de cr\u00e9dito do novo associado (2 d\u00edgitos)<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>ano_exp<\/code><\/td><td>Ano de vencimento do cart\u00e3o de cr\u00e9dito do novo associado (4 d\u00edgitos)<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>c\u00f3digo_de_seguran\u00e7a<\/code><\/td><td>C\u00f3digo de seguran\u00e7a (CVV) do cart\u00e3o de cr\u00e9dito do novo associado<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>shipping_same_as_billing<\/code><\/td><td>Isso pode ser definido como SIM ou N\u00c3O. Se for definido como YES, voc\u00ea n\u00e3o precisar\u00e1 fornecer informa\u00e7\u00f5es sobre o endere\u00e7o de entrega. NO \u00e9 o valor padr\u00e3o.<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito)<\/td><\/tr><tr><td><code>shipping_method<\/code><\/td><td>C\u00f3digo do m\u00e9todo de envio do m\u00e9todo de envio que voc\u00ea deseja aplicar ao pedido. Voc\u00ea pode&nbsp;<a href=\"https:\/\/membermouse.com\/pt\/documentos-3-2\/visao-geral-dos-metodos-de-envio\/\">encontrar c\u00f3digos de m\u00e9todos de envio na tela de m\u00e9todos de envio no MemberMouse<\/a>.<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>endere\u00e7o_de_envio<\/code><\/td><td>endere\u00e7o de entrega do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>cidade_de_envio<\/code><\/td><td>cidade de embarque do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>shipping_state<\/code><\/td><td>estado de envio do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>CEP de remessa<\/code><\/td><td>CEP de envio do novo membro<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>pa\u00eds_de_envio<\/code><\/td><td>pa\u00eds de expedi\u00e7\u00e3o do novo membro (<a href=\"http:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Officially_assigned_code_elements\" target=\"_blank\" rel=\"noreferrer noopener\">C\u00f3digo de pa\u00eds ISO de 2 d\u00edgitos<\/a>)<\/td><td>Condicional (N\u00e3o se o n\u00edvel de associa\u00e7\u00e3o for gratuito ou se o endere\u00e7o de entrega for o mesmo que o endere\u00e7o de cobran\u00e7a)<\/td><\/tr><tr><td><code>affiliate_id<\/code><\/td><td>ID de afiliado a ser criado com o pedido<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>sub_affiliate_id<\/code><\/td><td>ID da sub-afiliada para creditar no pedido<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>c\u00f3digo do cupom<\/code><\/td><td>C\u00f3digo de cupom v\u00e1lido que voc\u00ea deseja aplicar ao pedido<\/td><td>N\u00e3o<\/td><\/tr><tr><td><code>campo_personalizado_[ID#]<\/code><\/td><td>Voc\u00ea pode passar dados de campo personalizado para a API passando um ou mais par\u00e2metros no formul\u00e1rio custom_field_[ID#], em que [ID#] seria substitu\u00eddo pela ID do campo personalizado, conforme definido no MemberMouse. <br>Por exemplo, se o ID do campo personalizado for 4, voc\u00ea passaria os dados desse campo personalizado incluindo o par\u00e2metro custom_field_4.<\/td><td>N\u00e3o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">C\u00f3digos de resposta<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>200 - Sucesso<\/li>\n\n\n\n<li>409 - N\u00e3o foi poss\u00edvel criar um novo membro<\/li>\n<\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Dados de resposta<\/h5>\n\n\n\n<div style=\"height:5px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Par\u00e2metro<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><\/tr><tr><td><code>member_id<\/code><\/td><td>A ID do novo membro no MemberMouse<\/td><\/tr><tr><td><code>e-mail<\/code><\/td><td>O e-mail do novo membro<\/td><\/tr><tr><td><code>nome de usu\u00e1rio<\/code><\/td><td>O nome de usu\u00e1rio do novo membro<\/td><\/tr><tr><td><code>senha<\/code><\/td><td>A senha do novo membro<\/td><\/tr><tr><td><code>confirmationUrl<\/code><\/td><td>O URL da p\u00e1gina de confirma\u00e7\u00e3o associada \u00e0 compra. Ele tem uma chave de transa\u00e7\u00e3o anexada a ele para que o MemberMouse SmartTags\u2122 funcione nessa p\u00e1gina de confirma\u00e7\u00e3o.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>","protected":false},"excerpt":{"rendered":"<p>A chamada createMember API \u00e9 usada para criar um membro gratuito ou pago em seu site de associa\u00e7\u00e3o. Ela tamb\u00e9m pode ser usada para alterar o n\u00edvel de associa\u00e7\u00e3o de um membro existente. Se...<\/p>","protected":false},"author":21411,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_strive_editorial_status":"not-started","_strive_copy_of":0,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"ht-kb-category":[183],"ht-kb-tag":[],"class_list":["post-8041","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mm-api"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb\/8041","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/users\/21411"}],"replies":[{"embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/comments?post=8041"}],"version-history":[{"count":0,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb\/8041\/revisions"}],"wp:attachment":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/media?parent=8041"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb-category?post=8041"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb-tag?post=8041"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}