|
| 1 | +# gn-api-sdk-typescript |
1 | 2 |
|
| 3 | +> A nodejs module for integration of your backend with the payment services provided by [Gerencianet](http://gerencianet.com.br). |
| 4 | +
|
| 5 | +> Um módulo nodejs para integrar seu backend com os serviços de pagamento da [Gerencianet](http://gerencianet.com.br). |
| 6 | +
|
| 7 | +## Instalação |
| 8 | + |
| 9 | +```bash |
| 10 | +$ npm install gn-api-sdk-typescript |
| 11 | +``` |
| 12 | + |
| 13 | +## Uso Básico |
| 14 | + |
| 15 | +Importe o módulo: |
| 16 | + |
| 17 | +```typescript |
| 18 | +import Gerencianet from 'gn-api-sdk-typescript'; |
| 19 | +``` |
| 20 | + |
| 21 | +Insira suas credenciais e defina se deseja usar o sandbox ou não. |
| 22 | +Você também pode usar o arquivo [examples/config.ts](examples/config.ts) de modelo. |
| 23 | +```typescript |
| 24 | +export = { |
| 25 | + // PRODUÇÃO = false |
| 26 | + // HOMOLOGAÇÃO = true |
| 27 | + sandbox: false, |
| 28 | + |
| 29 | + // CREDENCIAIS DE PRODUÇÃO |
| 30 | + clientIdProducao: '', |
| 31 | + clientSecretProducao: '', |
| 32 | + pathCertProducao: '', |
| 33 | + |
| 34 | + // CREDENCIAIS DE HOMOLOGAÇÃO |
| 35 | + clientIdHomologacao: '', |
| 36 | + clientSecretHomologacao: '', |
| 37 | + pathCertHomologacao: '', |
| 38 | + |
| 39 | + // VALIDAR MTLS? |
| 40 | + validateMtls: false, |
| 41 | +}; |
| 42 | +``` |
| 43 | + |
| 44 | +Instancie o módulo passando as options: |
| 45 | + |
| 46 | +```typescript |
| 47 | +const gerencianet = Gerencianet(options); |
| 48 | +``` |
| 49 | + |
| 50 | +Crie uma cobrança: |
| 51 | + |
| 52 | +```typescript |
| 53 | +var body = { |
| 54 | + items: [{ |
| 55 | + name: 'Product A', |
| 56 | + value: 1000, |
| 57 | + amount: 2 |
| 58 | + }] |
| 59 | +} |
| 60 | + |
| 61 | +gerencianet |
| 62 | + .createCharge({}, body) |
| 63 | + .then(console.log) |
| 64 | + .catch(console.log) |
| 65 | + .done(); |
| 66 | +``` |
| 67 | + |
| 68 | +## Exemplos |
| 69 | + |
| 70 | +Para executar os exemplos, clone este repo e instale as dependências: |
| 71 | + |
| 72 | +```bash |
| 73 | +$ git clone git@github.com:gerencianet/gn-api-sdk-typescript.git |
| 74 | +$ cd gn-api-sdk-typescript/examples |
| 75 | +$ npm install |
| 76 | +``` |
| 77 | + |
| 78 | +Defina suas credenciais em config.ts: |
| 79 | + |
| 80 | +```typescript |
| 81 | +export = { |
| 82 | + // PRODUÇÃO = false |
| 83 | + // HOMOLOGAÇÃO = true |
| 84 | + sandbox: false, |
| 85 | + |
| 86 | + // CREDENCIAIS DE PRODUÇÃO |
| 87 | + clientIdProducao: '', |
| 88 | + clientSecretProducao: '', |
| 89 | + pathCertProducao: '', |
| 90 | + |
| 91 | + // CREDENCIAIS DE HOMOLOGAÇÃO |
| 92 | + clientIdHomologacao: '', |
| 93 | + clientSecretHomologacao: '', |
| 94 | + pathCertHomologacao: '', |
| 95 | + |
| 96 | + // VALIDAR MTLS? |
| 97 | + validateMtls: false, |
| 98 | +}; |
| 99 | +``` |
| 100 | + |
| 101 | +Em seguida, execute o exemplo que você deseja: |
| 102 | + |
| 103 | +```bash |
| 104 | +$ ts-node createCharge.ts |
| 105 | +``` |
| 106 | + |
| 107 | + |
| 108 | +## Documentação |
| 109 | + |
| 110 | +A documentação completa com todos os endpoints disponíveis você encontra em: https://dev.gerencianet.com.br/. |
| 111 | + |
| 112 | +## License |
| 113 | + |
| 114 | +[MIT](LICENSE) |
0 commit comments