CoDi chiavi private | DEUNA Docs

In questa pagina

1. Verifica le credenziali
2. Genera la chiave privata
3. Formattare la chiave privata
.cer chiave privata

Genera la chiave privata per operare CoDi tramite STP.

1. Verifica le credenziali#

Nell'Admin, cerca il STP Codi nell'opzione Connessione e aggiungere le seguenti credenziali:

Nome: Nome della connessione
Valuta: Per Codi, solo MXN è disponibile
Azienda: Nome della Società registrato con STP
Conto beneficiario: Numero di conto STP
Nome beneficiario: Nome beneficiario registrato con STP
Chiave privata: Chiave privata che deve essere generata. Puoi trovare maggiori dettagli nella sezione “Generate Private Key”.
Tempo di scadere: Tempo di scadenza di riferimento in pochi minuti.

2. Genera la chiave privata#

Creare la chiave privata in formato JKS eseguendo il seguente comando: Ejecutar el siguiente Maestro:

Shell

keytool -genkey -alias NombreDeLaEmpresa -keyalg RSA -keystore llavePrivada.jks -keysize 2048 -deststoretype jks -validity 370

3. Formattare la chiave privata#

Utilizzare i seguenti comandi se è necessario la chiave privata in altri formati.

JKS a P12

Shell

keytool -importkeystore -srckeystore llavePrivada.jks -destkeystore llavePrivada.p12 -srcstoretype jks -deststoretype pkcs12 -validity 370

P12 a PEM

Shell

openssl pkcs12 -in llavePrivada.p12 -out llavePrivada.pem

De P12 to PEM (para uso en JavaScript)

Shell

openssl pkcs12 -in llavePrivada.p12 -out llavePrivada.pem -nodes

.cer chiave privata#

Genera la chiave privata in cer.

Utilizzare i seguenti endpoint da CoDi:

Fine	Metodo	Descrizione
`/payment`	POST	Creare un pagamento e generare codice QR
`/payment/{id}`	GET	Recuperare lo stato di pagamento
`/refund`	POST	Richiesta di rimborso
`/webhook`	POST	Ricevi notifiche di stato di pagamento

Acquisto V2

Chiama il V2 Acquisto endpoint generare e ordinare in DEUNA.

Punto di arrivo: post {{apigw-url}}/v2/merchants/orders/purchase
Intestazioni:
- Authorization: Bearer {{user-token}}
- x-api-key: {{merchant-private-key}}

JSON

{
		"order_token":"{{order-token}}",
    "order_type": "DEUNA_CHECKOUT",
    "payer_info": {
        "email": "email1@email.com"
    },
    "payment_source": {
        "method_type": "bank_transfer",
        "processor": "stp_codi",
        "payment_method": "{{phone_number || empty}}", // Account number associated to STP account or empty to generate QR code
        "method_type_specific_fields": {
	          "description": "Test payment"
        }
    }
}

Restituisce l’ordine elaborato con

JSON

{
    "order_type": "DEUNA_NOW",
    "order_token": "4598f493-de86-4fe0-b9fd-c4c6c9847e39",
    "order": {
        "order_id": "DEUNA_NOW_b6a5c0b6-3df9-4b3b-b778-7086c190062b",
        "store_code": "all",
        "currency": "MXN",
        "tax_amount": 10000,
        "display_tax_amount": "",
        "shipping_amount": 10000,
        "display_shipping_amount": "MXN 100,00",
        "items_total_amount": 10000,
        "display_items_total_amount": "MXN 100,00",
        "sub_total": 10000,
        "display_sub_total": "MXN 100,00",
        "total_amount": 10000,
        "display_total_amount": "MXN 100,00",
        "status": "pending",
        "payment": {
            "data": {
                "amount": {
                    "amount": 10000,
                    "currency": "MXN"
                },
                "metadata": {
                    "key1": "value1",
                    "key2": "value2"
                },
                "updated_at": "2024-12-05 18:28:14.726950103 +0000 UTC",
                "method_type": "bank_transfer",
                "merchant": {
                    "store_code": "all",
                    "id": "e25c4fff-ef50-498b-9a3c-5937d96280f7"
                },
                "created_at": "2024-12-05 18:28:14.725709716 +0000 UTC",
                "id": "DEUNA_NOW_b6a5c0b6-3df9-4b3b-b778-7086c190062b",
                "processor": "stp_codi",
                "payment_method_type": "push_notification",
                "customer": {
                    "email": "email@email.com",
                    "id": "ac434d25-1f42-44b5-883f-fa1b2a08eec6",
                    "first_name": "",
                    "last_name": ""
                },
                "status": "pending",
                "next_action": {
                    "action": "authorization_bank_transfer",
                    "authorization_bank_transfer": {
                        "reference": "{{folioCodi}}",
                        "expiration_date": "2025-05-05 14:20:50",
                        "qr": ""
                    }
                },
                "reason": "",
                "external_transaction_id": "{{folioCodi}}",
                "merchant_payment_processor_name": "",
                "authorization_code": "",
                "installment_interest_calculations": null
            }
        },
        ...
    }
}

Stato di pagamento

Stato di CoDI	Stato DEUNA	Descrizione
`pending`	`pending`	Pagamento in attesa di conferma
`completed`	`processed`	Pagamento completato
`failed`	`denied`	Pagamento fallito
`expired`	`expired`	Codice QR scaduto senza pagamento