From ca976cd0b385646dc9a57131a6dcdac0ea79baf9 Mon Sep 17 00:00:00 2001 From: Mohit kandhari <65109464+cwmohit@users.noreply.github.com> Date: Thu, 1 Oct 2020 00:36:32 +0530 Subject: [PATCH] Update README.md --- README.md | 160 +++++++++++++++++++++++++++--------------------------- 1 file changed, 80 insertions(+), 80 deletions(-) diff --git a/README.md b/README.md index d89d2f7..bde18ff 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ -SDK Moip-PHP - API +SDK Moip-PHP - API - An amazing project ==================================================== -O Moip-PHP é uma biblioteca que implementa uma camada de abstração para geração do XML de instruções do Moip, permitindo que você integre aos serviços de API sem poluir seu código com várias linhas de XML. Um exemplo rápido: +O Moip-PHP é uma biblioteca que implementa uma camada de abstração para geração do XML de instruções do Moip, permitindo que você integre aos serviços de API sem poluir seu código com várias linhas de XML. Um exemplo rápido: include_once "autoload.inc.php"; @@ -21,7 +21,7 @@ O Moip-PHP print_r($moip->send()); -O Moip-PHP utiliza o padrão Fluent Interfaces, portanto, você pode fazer o exemplo acima da seguinte forma: +O Moip-PHP utiliza o padrão Fluent Interfaces, portanto, você pode fazer o exemplo acima da seguinte forma: include_once "autoload.inc.php"; @@ -37,16 +37,16 @@ O Moip-PHP utiliza o padr ->send()); ------------------------------------- -Métodos disponíveis +Métodos disponíveis ---------- -Veja baixo relação e detalhes dos métodos disponíveis que você poderá utilizar com o Moip-PHP. +Veja baixo relação e detalhes dos métodos disponíveis que você poderá utilizar com o Moip-PHP. ------------------------------------- Moip() ---------- -Método construtor. +Método construtor. Moip() @@ -55,10 +55,10 @@ Moip() setEnvironment() ---------- -Método que define o ambiente em qual o requisição será processada, 'test' para definir que será em ambiente de testes Moip o Sandbox, a omissão desse método define que a requisição deverá ser processada em ambiente real, de produção Moip. +Método que define o ambiente em qual o requisição será processada, 'test' para definir que será em ambiente de testes Moip o Sandbox, a omissão desse método define que a requisição deverá ser processada em ambiente real, de produção Moip. -Importante: ao definir o ambiente certifique-se de que está utilizando a autenticação correspondente ao ambiente, no Moip cada ambiente possui suas própria chaves de autenticação API. +Importante: ao definir o ambiente certifique-se de que está utilizando a autenticação correspondente ao ambiente, no Moip cada ambiente possui suas própria chaves de autenticação API. setEnvironment($environment) $environment : String ('test') @@ -68,9 +68,9 @@ $environment : String ('test') setCredential() ---------- -O Moip requer que você se autentique para que seja possivel processar requisições em sua API, para isso antes de realizar qualquer requisição você deverá informar ao Moip suas credenciais da API formados por um TOKEN e uma KEY. +O Moip requer que você se autentique para que seja possivel processar requisições em sua API, para isso antes de realizar qualquer requisição você deverá informar ao Moip suas credenciais da API formados por um TOKEN e uma KEY. -O parâmetro $credencials é um array associativo contendo as chaves key e token (ex: array('key'=>'sua_key','token'=>'seu_token')). Se você ainda não possui estes dados, veja como obtelas tarvés em sua conta Sandbox. +O parâmetro $credencials é um array associativo contendo as chaves key e token (ex: array('key'=>'sua_key','token'=>'seu_token')). Se você ainda não possui estes dados, veja como obtelas tarvés em sua conta Sandbox. setCredential($credential) @@ -85,10 +85,10 @@ O par validate() ---------- -O método validate() irá realizar a validação dos dados obrigatórios para o tipo de instrução que você deseja processar, você pode optar por um dos dois níveis de validação disponíveis o 'Basic' e 'Identification'. +O método validate() irá realizar a validação dos dados obrigatórios para o tipo de instrução que você deseja processar, você pode optar por um dos dois níveis de validação disponíveis o 'Basic' e 'Identification'. -1. Basic : Irá realizar a validação dos dados mínimos de para uma requisição XML ao Moip. -2. Identification : Irá validar os dados necessários para se processar um XML com identificação Moip, usados geralmente para redirecionar o cliente já no segundo step da pagina de pagamento no checkout Moip ou usar o Moip Transparente. +1. Basic : Irá realizar a validação dos dados mínimos de para uma requisição XML ao Moip. +2. Identification : Irá validar os dados necessários para se processar um XML com identificação Moip, usados geralmente para redirecionar o cliente já no segundo step da pagina de pagamento no checkout Moip ou usar o Moip Transparente. validate($validateType) @@ -100,9 +100,9 @@ O m setUniqueID() ---------- -O método setUniqueID() atribui valor a tag "<IdProprio>" no XML Moip. +O método setUniqueID() atribui valor a tag "<IdProprio>" no XML Moip. -1. <IdProprio>: Seu identificador único de pedido, essa mesma informações será enviada para você em nossas notificações de alterações de status para que você possa identificar o pedido e tratar seu status. +1. <IdProprio>: Seu identificador único de pedido, essa mesma informações será enviada para você em nossas notificações de alterações de status para que você possa identificar o pedido e tratar seu status. setUniqueID($id) @@ -114,9 +114,9 @@ $id : String setValue() ---------- -O método setValue() atribui valor a tag "<Valor>" no XML Moip. +O método setValue() atribui valor a tag "<Valor>" no XML Moip. -1. <Valor>: Responsável por definir o valor que deverá ser pago. +1. <Valor>: Responsável por definir o valor que deverá ser pago. setValue($value) @@ -127,9 +127,9 @@ $value : Numeric setAdds() --------------- -O método setAdds() atribui valor a tag "<Acrescimo>" no XML Moip. +O método setAdds() atribui valor a tag "<Acrescimo>" no XML Moip. -1. <Acrescimo>: Responsável por definir o valor adicional que deverá ser pago. +1. <Acrescimo>: Responsável por definir o valor adicional que deverá ser pago. setAdds($value) @@ -141,9 +141,9 @@ $value : Numeric setDeduct() --------------- -O método setDeduct() atribui valor a tag "<Deducao>" no XML Moip. +O método setDeduct() atribui valor a tag "<Deducao>" no XML Moip. -1. <Deducao>: Responsável por definir o valor de desconto que será subtraído do total a ser pago. +1. <Deducao>: Responsável por definir o valor de desconto que será subtraído do total a ser pago. setDeduct($value) @@ -154,10 +154,10 @@ $value : Numeric setReason() --------------- -O método setReason() atribui valor a tag "<Razao>" no XML Moip. +O método setReason() atribui valor a tag "<Razao>" no XML Moip. -1. <Razao>: Responsável por definir o motivo do pagamento. -1. Este campo é sempre obrigatório em um instrução de pagamento. +1. <Razao>: Responsável por definir o motivo do pagamento. +1. Este campo é sempre obrigatório em um instrução de pagamento. setReason($value) @@ -168,24 +168,24 @@ $value : String setPayer() --------------- -O método setPayer() atribui valores ao nodo "<Pagador>" no XML Moip. +O método setPayer() atribui valores ao nodo "<Pagador>" no XML Moip. -1. <Pagador>: Nodo de informações de quem está realizando o pagamento. +1. <Pagador>: Nodo de informações de quem está realizando o pagamento. 1. name : <Nome> : Nome completo do pagador 2. email : <Email> : E-mail do pagador 3. payerId : <IdPagador> : Identificados unico do pagador 4. identity : <Identidade> : Identidade do pagador (CPF) -5. phone : <TelefoneCelular> : Telefone de contato secundário do pagador -6. billingAddress : <EnderecoCobranca> : Endereço do pagador +5. phone : <TelefoneCelular> : Telefone de contato secundário do pagador +6. billingAddress : <EnderecoCobranca> : Endereço do pagador 1. address : <Logradouro> : Logradouro do pagador, rua, av, estrada, etc. 2. number : <Numero> : Numero residencial do pagador -3. complement : <Complemento> : Complemento do endereço do pagador -4. city : <Cidade> : Cidade do endereço do pagador -5. neighborhood : <Bairro> : Bairro do endereço do pagador -6. state : <Estado> : Estado do endereço do pagador em formato ISO-CODE (UF) +3. complement : <Complemento> : Complemento do endereço do pagador +4. city : <Cidade> : Cidade do endereço do pagador +5. neighborhood : <Bairro> : Bairro do endereço do pagador +6. state : <Estado> : Estado do endereço do pagador em formato ISO-CODE (UF) 7. country : <Pais> : Pais do pagador em formato ISO-CODE -8. zipCode : <CEP> : CEP de endereço +8. zipCode : <CEP> : CEP de endereço 9. phone : <TelefoneFixo> : Telefone de contato do pagador setPayer($value) @@ -195,11 +195,11 @@ $value : Array ('name','email','payerId','identity', 'phone','billingAddress' => $moip->setPayer(array('name' => 'Nome Sobrenome', 'email' => 'email@cliente.com.br', 'payerId' => 'id_usuario', - 'billingAddress' => array('address' => 'Rua do Zézinho Coração', + 'billingAddress' => array('address' => 'Rua do Zézinho Coração', 'number' => '45', 'complement' => 'z', - 'city' => 'São Paulo', - 'neighborhood' => 'Palhaço Jão', + 'city' => 'São Paulo', + 'neighborhood' => 'Palhaço Jão', 'state' => 'SP', 'country' => 'BRA', 'zipCode' => '01230-000', @@ -208,14 +208,14 @@ $value : Array ('name','email','payerId','identity', 'phone','billingAddress' => addPaymentWay() --------------- -O método addPaymentWay() atribui valor a tag "<FormaPagamento>" do nodo "<FormasPagamento>" no XML Moip. +O método addPaymentWay() atribui valor a tag "<FormaPagamento>" do nodo "<FormasPagamento>" no XML Moip. -<FormaPagamento>: Define quais as formas de pagamento que serão exibidas ao pagador no Checkout Moip. -1. billet : Para disponibilizar a opção "Boleto Bancário" como forma de pagamento no checkout Moip. -2. financing : Para disponibilizar a opção "Financiamento" como forma de pagamento no checkout Moip. -3. debit : Para disponibilizar a opção "Debito em conta" como forma de pagamento no checkout Moip. -4. creditCard : Para disponibilizar a opção "Cartão de Crédito" como forma de pagamento no checkout Moip. -5. debitCard : Para disponibilizar a opção "Cartão de débito" como forma de pagamento no checkout Moip. +<FormaPagamento>: Define quais as formas de pagamento que serão exibidas ao pagador no Checkout Moip. +1. billet : Para disponibilizar a opção "Boleto Bancário" como forma de pagamento no checkout Moip. +2. financing : Para disponibilizar a opção "Financiamento" como forma de pagamento no checkout Moip. +3. debit : Para disponibilizar a opção "Debito em conta" como forma de pagamento no checkout Moip. +4. creditCard : Para disponibilizar a opção "Cartão de Crédito" como forma de pagamento no checkout Moip. +5. debitCard : Para disponibilizar a opção "Cartão de débito" como forma de pagamento no checkout Moip. addPaymentWay($way) @@ -230,12 +230,12 @@ $way : String ('billet','financing','debit','creditCard','debitCard') setBilletConf() --------------- -O método setBilletConf() atribui valores ao node "<Boleto>" no XML Moip que é responsável por definir as configurações adicionais e personalização do Boleto bancário. +O método setBilletConf() atribui valores ao node "<Boleto>" no XML Moip que é responsável por definir as configurações adicionais e personalização do Boleto bancário. 1. $expiration : Data em formato "AAAA-MM-DD" ou quantidade de dias. -2. $workingDays : Caso "$expiration" seja quantidade de dias você pode definir com "true" para que seja contado em dias úteis, o padrão será dias corridos. -3. $instructions : Mensagem adicionais a ser impresso no boleto, até três mensagens. -4. $uriLogo : URL de sua logomarca, dimensões máximas 75px largura por 40px altura. +2. $workingDays : Caso "$expiration" seja quantidade de dias você pode definir com "true" para que seja contado em dias úteis, o padrão será dias corridos. +3. $instructions : Mensagem adicionais a ser impresso no boleto, até três mensagens. +4. $uriLogo : URL de sua logomarca, dimensões máximas 75px largura por 40px altura. setBilletConf($expiration, $workingDays, $instructions, $uriLogo) @@ -257,7 +257,7 @@ $uriLogo : String addMessage() --------------- -O método addMessage() atribui valor a tag "<Mensagem>" do node "<Mensagens>" no XML Moip. +O método addMessage() atribui valor a tag "<Mensagem>" do node "<Mensagens>" no XML Moip. 1. <Mensagens>: Node com "<Mensagens>". 1. <Mensagem>: TAG que define mensagem adicional a ser exibida no checkout Moip. @@ -271,7 +271,7 @@ $msg : String setReturnURL() --------------- -O método setReturnURL() atribui valor a tag "<URLRetorno>" no XML Moip, responsável por definir a URL que o comprador será redirecionado ao finalizar um pagamento através do checkout Moip. +O método setReturnURL() atribui valor a tag "<URLRetorno>" no XML Moip, responsável por definir a URL que o comprador será redirecionado ao finalizar um pagamento através do checkout Moip. setReturnURL($url) @@ -282,7 +282,7 @@ $url : String setNotificationURL() --------------- -O método setNotificationURL() atribui valor a tag "<URLNotificacao>" no XML Moip, responsável por definir a URL ao qual o Moip deverá notificar com o NASP (Notificação de Alteração de Status de Pagamento) as mudança de status. +O método setNotificationURL() atribui valor a tag "<URLNotificacao>" no XML Moip, responsável por definir a URL ao qual o Moip deverá notificar com o NASP (Notificação de Alteração de Status de Pagamento) as mudança de status. setNotificationURL($url) @@ -293,14 +293,14 @@ $url : String addComission() --------------- -O método addComission() atribui valores as tags "<Comissoes>" no XML Moip, responsável por atribuir recebedores secundários a transação. +O método addComission() atribui valores as tags "<Comissoes>" no XML Moip, responsável por atribuir recebedores secundários a transação. -1. $reason : Razão/Motivo ao qual o recebedor secundário receberá o valor definido. -2. $receiver: Login Moip do usuario que receberá o valor. -3. $value : Valor ao qual será destinado ao recebedor secundário. -4. $percentageValue: Caso "true" define que valor será calculado em relação ao percentual sobre o valor total da transação. -5. $ratePayer: Caso "true" define que esse recebedor secundário irá pagar a Taxa Moip com o valor recebido. +1. $reason : Razão/Motivo ao qual o recebedor secundário receberá o valor definido. +2. $receiver: Login Moip do usuario que receberá o valor. +3. $value : Valor ao qual será destinado ao recebedor secundário. +4. $percentageValue: Caso "true" define que valor será calculado em relação ao percentual sobre o valor total da transação. +5. $ratePayer: Caso "true" define que esse recebedor secundário irá pagar a Taxa Moip com o valor recebido. addComission($reason, $receiver, $value, $percentageValue, $ratePayer) @@ -314,10 +314,10 @@ $percentageValue: Boolean $ratePayer : Boolean - $moip->addComission('Razão do Split', + $moip->addComission('Razão do Split', 'recebedor_secundario', '5.00'); - $moip->addComission('Razão do Split', + $moip->addComission('Razão do Split', 'recebedor_secundario_2', '12.00', true, @@ -326,13 +326,13 @@ $ratePayer : Boolean addParcel() --------------- -O método addParcel() atribui valores as tags de "<Parcelamentos>" no XML Moip, responsável configuras as opções de parcelamento que serão disponíveis ao pagador. +O método addParcel() atribui valores as tags de "<Parcelamentos>" no XML Moip, responsável configuras as opções de parcelamento que serão disponíveis ao pagador. -1. $min : Quantidade mínima de parcelas disponível ao pagador. -2. $max : Quantidade máxima de parcelas disponíveis ao pagador. +1. $min : Quantidade mínima de parcelas disponível ao pagador. +2. $max : Quantidade máxima de parcelas disponíveis ao pagador. 3. $rate : Valor de juros a.m por parcela. -4. $transfer : Caso "true" define que o valor de juros padrão do Moip será pago pelo pagador. +4. $transfer : Caso "true" define que o valor de juros padrão do Moip será pago pelo pagador. addParcel($min, $max, $rate, $transfer) @@ -352,7 +352,7 @@ $transfer : Boolean setReceiver() --------------- -O método setReceiver() atribui valor a tag "<LoginMoIP>" do node "<Recebedor>" que identifica o usuário Moip que irá receber o pagamento no Moip. +O método setReceiver() atribui valor a tag "<LoginMoIP>" do node "<Recebedor>" que identifica o usuário Moip que irá receber o pagamento no Moip. 1. $receiver : Login Moip do recebedor primario. @@ -367,7 +367,7 @@ $receiver : String getXML() --------------- -O método getXML() irá retornar o XML gerado com todos os atributos que você configurou, esse método pode ajudar a saber exatamente o XML que você irá enviar ao Moip. +O método getXML() irá retornar o XML gerado com todos os atributos que você configurou, esse método pode ajudar a saber exatamente o XML que você irá enviar ao Moip. getXML() @@ -385,7 +385,7 @@ getXML() print_r($moip->getXML()); - //IRÃ? IMPRIMIR + //IRÃ? IMPRIMIR @@ -400,12 +400,12 @@ getXML() send() --------------- -O método send() executa o envio da instrução ao Moip, e retorna os dados de resposta obtidos do Moip. +O método send() executa o envio da instrução ao Moip, e retorna os dados de resposta obtidos do Moip. 1. response : "true" para o caso de sucesso e "false" para quando ocorre algum erro. -2. error : Retorna sempre uma mensagem quando "response" é "false". -3. xml: Retorna sempre o XML de resposta Moip quando "response" é "true". +2. error : Retorna sempre uma mensagem quando "response" é "false". +3. xml: Retorna sempre o XML de resposta Moip quando "response" é "true". send() @@ -422,7 +422,7 @@ send() print_r($moip->send()); - //IRÃ? IMPRIMIR + //IRÃ? IMPRIMIR stdClass Object ( [response] => 1 @@ -433,12 +433,12 @@ send() getAnswer() --------------- -O método getAnswer() retorna os dados de resposta do Moip em forma de objeto. +O método getAnswer() retorna os dados de resposta do Moip em forma de objeto. 1. response : "true" para o caso onde o "<Status>" Moip retornou "Sucesso" e "false" para quando retornou "Falha". -2. error : Retorna sempre uma mensagem quando "response" é "false". -3. token: Retorna o TOKEN de pagamento gerado para quando "response" é "true". -4. payment_url : Retorna a URL de checkout Moip preparada para redirecionar o cliente com o TOKEN de pagamento para quando "response" é "true". +2. error : Retorna sempre uma mensagem quando "response" é "false". +3. token: Retorna o TOKEN de pagamento gerado para quando "response" é "true". +4. payment_url : Retorna a URL de checkout Moip preparada para redirecionar o cliente com o TOKEN de pagamento para quando "response" é "true". getAnswer() @@ -457,7 +457,7 @@ getAnswer() print_r($moip->getAnswer()); - //IRÃ? IMPRIMIR + //IRÃ? IMPRIMIR stdClass Object ( [response] => 1 @@ -469,13 +469,13 @@ getAnswer() queryParcel() --------------- -O método queryParcel() retorna um Array() contendo as informações de parcelas e seus respectivos valores cobrados por parcela e o valor total a ser pago referente a taxa de juros simulada.. +O método queryParcel() retorna um Array() contendo as informações de parcelas e seus respectivos valores cobrados por parcela e o valor total a ser pago referente a taxa de juros simulada.. 1. REQUEST 2. $login: Login Moip do usuario. -3. $maxParcel: Máximo de parcelar a ser consultado. -4. $rate: Taxa de juros para simulação. -5. $simulatedValue: Valor pago ao qual será simulado. +3. $maxParcel: Máximo de parcelar a ser consultado. +4. $rate: Taxa de juros para simulação. +5. $simulatedValue: Valor pago ao qual será simulado. 6. RESPONSE 7. response : "true" em caso de resposta Moip com "<Status>" "Sucesso" e "false" em caso de "Falha" @@ -505,7 +505,7 @@ $simulatedValue: Number print_r($moip->queryParcel('integracao@labs.moip.com.br', '4', '1.99', '100.00')); - //IRÃ? IMPRIMIR + //IRÃ? IMPRIMIR Array ( [response] => 1 @@ -547,4 +547,4 @@ $simulatedValue: Number ) ---------------- \ No newline at end of file +---------------