@controleonline/react-native-getnet-payment
Módulo React Native para integração de pagamentos com terminais Getnet POS via deeplink.
Suporta crédito, débito, voucher, PIX, estorno, reimpressão e consulta de status.
Apenas Android. Requer o app de pagamentos da Getnet instalado no terminal.
Instalação
npm install @controleonline/react-native-getnet-payment
# ou
yarn add @controleonline/react-native-getnet-payment
Android
-
minSdkVersion>= 22 -
Registre o package no
MainApplication.java/MainApplication.kt:
import com.controleonline.pos.getnet.payment.GetnetPackage;
// em getPackages():
packages.add(new GetnetPackage());
Uso
import Getnet from '@controleonline/react-native-getnet-payment';
import { v4 as uuidv4 } from 'uuid';
// Pagamento crédito à vista
const result = await Getnet.payment({
amount: 15.0,
paymentType: 'credit', // credit | debit | voucher | pix
callerId: uuidv4(),
installments: 1,
// creditType: 'creditMerchant' | 'creditIssuer', // só se installments > 1
// allowPrintCurrentTransaction: true,
// orderId: 'PEDIDO-123',
});
if (result.success) {
console.log('Aprovado!', result.authorizationCode, result.nsu);
} else {
console.log('Falhou:', result.result, result.resultDetails);
}
// Estorno
await Getnet.refund({
amount: 15.0,
cvNumber: result.cvNumber,
// transactionDate: '150921',
// originTerminal: '...',
});
// Reimpressão do último comprovante
await Getnet.reprint();
// Consulta de status
await Getnet.checkStatus(callerId);
Métodos
payment(params)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
amount | number | sim | Valor em reais (ex: 15.50) |
paymentType | string | sim | credit, debit, voucher ou pix |
callerId | string | sim | Identificador único da transação |
installments | number | não | Parcelas (1–12). Débito deve ser 1 |
creditType | string | não | creditMerchant ou creditIssuer (parcelado) |
allowPrintCurrentTransaction | boolean | não | Imprimir comprovante |
orderId | string | não | ID do pedido |
refund(params)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
amount | number | sim | Valor em reais |
cvNumber | string | não | Número do CV da transação original |
transactionDate | string | não | Data da transação |
originTerminal | string | não | Terminal de origem |
allowPrintCurrentTransaction | boolean | não | Imprimir comprovante |
reprint()
Reimprime o comprovante da última transação.
checkStatus(callerId)
Consulta o status de uma transação pelo callerId.
Resposta
{
result: "0", // "0" = sucesso
resultDetails: "TRANSACAO APROVADA",
success: true,
amount: "000000001500",
callerId: "...",
nsu: "...",
cvNumber: "...",
authorizationCode: "...",
cardBin: "...",
cardLastDigits: "...",
brand: "...",
installments: "...",
nsuLocal: "...",
// ... demais campos retornados pelo app Getnet
}
Códigos de result
| Código | Significado |
|---|---|
0 | Sucesso |
1 | Negada |
2 | Cancelada |
3 | Falha |
4 | Desconhecido |
5 | Pendente |
Deeplinks
| Operação | URI |
|---|---|
| Pagamento | getnet://pagamento/v3/payment?... |
| Estorno | getnet://pagamento/v1/refund?... |
| Reimpressão | getnet://pagamento/v1/reprint |
| Status | getnet://pagamento/v1/checkstatus?callerId=... |
Requisitos
- Terminal Getnet (Smart POS) com app de pagamentos instalado
- Android API 22+
- React Native
Referências
License
MIT