Prosa
Nesta página
Esta página fornece um guia para integrar Prosa com DEUNA.
Operações suportadas
A integração do Prosa na sua estratégia de pagamento com DEUNA permite realizar as seguintes operações:
| Operação | Nome Prosa | Solicitação/resposta MTI | Comentário |
|---|---|---|---|
| Autorização | Check-in | 0200 / 0210 | Campo 3: "000000" Field 125: "**HOSTB24 00" Field 126: "(hold days)+000****000000" |
| Compra (captura automática) | Venta | 0200 / 0210 | Campo 3: "000000" Field 125: "**HOSTB24 10" Field 126: "0000****000000" |
| Reembolso total – dia seguinte/reembolso parcial | Devolução | 0200 / 0210 | Campo 3: "020000" Field 125: "**HOSTB24 10" |
| Captura total/parcial | Check-out | 0220 / 0230 | |
| Reembolso total – mesmo dia | Reverso | 0420 / 0430 | |
| Vazio | Reverso | 0420 / 0430 |
Recursos suportados
- 3DS (Deuna ou MPI externo)
- Pagamentos recorrentes
- MSI / MCI
- MOTO
Métodos de pagamento suportados
- Cartões de Débito e Crédito: Visa e Mastercard.
Integrar Prosa#
Após pesquisar o Prosa no Connections, você deve configurar o Prosa em sua loja.
1. Configure o Prosa na sua loja
No Connections, uma janela como a seguinte será aberta:
-
Insira as seguintes credenciais:
Credencial
Campo Prosa
Descrição
Valor no Sandbox
Moeda
Moeda do processador
MXN
MCC
18 MERCHANT TYPE
Linha de negócios (MCC)
4 dígitos código. Por exemplo 3076
Código de Adquirente
32 ACQUIRING INSTITUTION ID CODE
Adquirindo código bancário
"127" para BAZ
Merchant ID
42 CARD ACCEPTOR ID CODE
Código do instituição que aceita a transação. Sugerido enviar como "00000000"
Código fornecido pela Prosa
Código de identificação da instituição receptora
100 RECEIVING INSTITUTION ID CODE
Aplica-se apenas a interruptores. Envie o valor "000000000"
9 dígitos código fornecido pela Prosa, caso não esteja disponível, coloque "000000000"
Retenção de pré-autorização (dias)
126.2 Retenção de pré-autorização
Dias em que você quer autorização para permanecer válido. Sugerido manter como "00"
Exemplo: "2"
Terminal de identificação
41 CARD ACCEPTOR TERMINAL ID
Terminal ID, atribuído pela DEUNA (Pode ser qualquer valor, mesmo repetido)
Valor sugerido: "00000001"
Afiliação
148.2 Retailer ID
Código de afiliação fornecido pelo Banco do Comerciante (7 dígitos para MX)
Exemplo: "8092738"
Nome do Terminal
120.2 Nome do Terminal
Código do terminal em Deuna
"DEUNA T1"
Proprietário do terminal
60.2 Proprietário FIID
FIID do banco - B, P ou D dependendo do banco + 3 dígitos
"B127" Para BAZ
Red Lógica do Terminal
60.3 Rede Lógica
Rede lógica Deuna com Prosa. Valor constante "DUNA"
"DUNA"
Compensação de horário do terminal em minutos (por exemplo, +1h -> +060)
60.4 Compensação de horário
Diferença horária do terminal com Prosa. Valor constante "+000"
Valor sugerido: "+000"
Cidade Terminal
43.2 Terminal Cidade
Abreviatura da cidade onde a empresa está localizada (máximo de 4 caracteres)
Exemplo: "CDMX"
Estado Terminal
43.3 Estado Terminal
Informe onde a empresa está localizada (dois dígitos)
Exemplo: "DF"
País Terminal
43.4 País Terminal
País onde a empresa está localizada (dois dígitos)
Exemplo: "MX"
CEP do Terminal
- POSTAL CODE
Código postal onde a empresa está localizada (5 dígitos)
Exemplo: "11510"
-
Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
-
Escolha se deseja ativar o 3DS.
-
Clique Conectar.
2. Processar transações no Prosa
A partir deste momento, já pode processar transações com Prosa através da DEUNA.
#
3. Teste sua conexão Prosa no Sandbox
Credenciais
Moneda *
MXN
MCC *
3076
Código de Adquirente *
127
Merchant ID *
123456789
Receiving Institution Id Code *
000000000
Pre Authorization hold (days) *
2
ID Terminal *
00000001
Afiliación *
8092738
Terminal Name *
DEUNA T1
Dueño de la Terminal *
B127
Red Lógica de la Terminal *
DUNA
Time Offset de la Terminal en Minutos (e.g +1h -> +060) *
+000
Terminal City *
CDMX
Terminal State *
DF
Terminal Country *
MX
Terminal ZIP Code *
11510Simule aprovações e negações
- Approve transactions: order.total_amount <10000 cents
- Deny transactions: order.total_amount > 9999 and < 1000000 cents
"order": {
"total_amount": 10100, //larger than 9999 cents, then, denied.Testando assinaturas e pagamentos recorrentes
-
Campos de recorrência a serem incluídos na solicitação de compra v2:
Nome do campo Tipo Valores Comentários card_idUUID Obtido ao armazenar (tokenizar) o cartão no cofre de Deuna:
- O card_id é único para cada PAN e Vencimento do cartão de crédito.
- Um comerciante pode armazenar o mesmo card_id para contas diferentes.initiator_typeString ENUM (obrigatório) customer,merchantDefinir se a transação é gerada pelo titular do cartão ou pelo estabelecimento comercial recurrence.first_time_useBooleano (obrigatório) true,falsePara definir se é a primeira transação da série ou uma subsequente recurrence.scheduledBooleano (opcional) true,falsePara definir se o pagamento recorrente recurrence.idUUID Obtido ao solicitar uma primeira transação de uma série recorrente. recurrence.bill_referenceString Obrigatório apenas em pagamentos periódicos solicitados pelo lojista como assinaturas. -
Campos relacionados à assinatura Prosa e pagamentos recorrentes
Campo Prosa
Valores
Comprar entrada V2
Campo 22 (modo de entrada POS)
01: Primeira Transação
10: Transação subsequenterecurrence.first_time_useCampo 25 (Código de Condição POS)
00: Iniciado pelo cliente
01: Iniciado pelo comerciante
08: MOTOinitiator_typemarket_typeCampo 63 - Token Q2
09: Pagamento não agendado (comércio eletrônico)
02: Pagamento programado automático
08: Transações MOTOinitiator_typerecorrência.programadamarket_typeCampo 63 – Token PJ
Primeiro dígito:
- E: Primeira transação
- M: transação subsequente iniciada pelo comerciante
- C: Transação subsequente do cliente iniciada pelo cliente
- " ": Cliente-Não agendadoSegundo dígito:
- C: Pagamento Não Programado
- R: Pagamento Agendadoinitiator_typerecorrência.first_time_userecurrence.scheduledCampo 63 - Token C4
Iniciado pelo cliente: "1025100Y3660"
Iniciado pelo comerciante: "102410003660"
Transações MOTO: "203310003014"
Y*: Resultados antifraude ou 3DS (0, 1, 2)initiator_typerecorrência.first_time_usemarket_typeCampo 63 - Token R4
String
recurrence.bill_referenceCampo 63 - Ficha 17
ID de transação de rede para Visa
Relacionado a
recurrence.id, obtido na primeira transação e enviado nas subsequentes,Campo 63 - Ficha 20
ID de transação de rede para MC
Relacionado a
recurrence.id, obtido na primeira transação e enviado nas subsequentesCampo 63 - Token CH
Valor dependendo se está agendado e se foi solicitado pelo cliente ou pelo comerciante
initiator_typerecorrência.first_time_userecurrence.scheduled
Coleção do Postman
Solicite o ambiente e a coleção Prosa Postman atuais à sua equipe de integração DEUNA.