Transbancaire
Cette page fournit un guide pour intégrer Transbank à DEUNA.
Opérations prises en charge
L'intégration Transbank dans votre stratégie de paiement avec DEUNA vous permet d'effectuer les opérations suivantes :
- Achat
- Autorisation*
- Capture complète*
- Captures partielles*
- Remboursement partiel
- Remboursement intégral
- Vide*
- Acompte
Méthodes de paiement prises en charge
Cartes
- Visa
- Carte Master
- Amex
Pays et devises actifs
- Chili (CLP)
Exigences
Contactez votre représentant Transbank et demandez les justificatifs suivants :
- Secret de clé API (
Tbk-Api-Key-Secret) - Numéro d'identification du commerçant (
Tbk-Api-Key-Id)
Intégration des banques#
Après avoir cherché Transbank dans Connections, vous devez configurer la connexion dans votre magasin.
1. Configurez Transbank dans votre magasin
Dans Connexions, une fenêtre comme celle-ci s'ouvrira :
- Saisissez les informations d'identification suivantes :
- Dans Nom entrez un nom pour référencer les informations d'identification.
- Dans Devise sélectionnez la devise du processeur marchand disponible.
- Dans Commerce ID entrez l'identifiant de la banque Trans (
Tbk-Api-Key-Id). - Dans Clé privée entrez le secret clé API de la Transbank (
Tbk-Api-Key-Secret). - Dans Magasin entrez le code de magasin de Transbank (tienda) si vous traitez sous Transacción Completa Mall. Sinon, laissez ce paramètre vide.
- Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
- Cliquez Se connecter.
Une fois les étapes terminées, vous verrez un message de réussite.
3. Traiter les paiements avec Transbank
Ensuite, vous pourrez voir votre connexion Transbank dans l'onglet Connexions actives.
À partir de ce moment, vous pouvez maintenant traiter les transactions avec Transbank via DEUNA.
Exemple d'achat v2
JSON
{
"payer_info": {
"email": "test_chile@testuser.com",
"date_of_birth": "1990-08-30T16:00:00.000Z"
},
"payment_source": {
"method_type": "credit_card",
"card_info": {
"card_number": "4051885600446623",
"card_holder": "JUAN PÉREZ",
"expiry_month": "08",
"expiry_year": "30",
"card_cvv": "123",
"card_holder_dni": "12.345.678-5",
"zip": "8320000",
"city": "Santiago",
"address1": "Av. Apoquindo 3000",
"state": "Región Metropolitana",
"phone": "+56228901234",
"country": "CL"
}
},
"order": {
"order_id": "fee5036f-8251-4101-8ecc-74259e6e040b",
"currency": "CLP",
"items": [
{
"id": "TK001",
"name": "Tiquete Aéreo Santiago - Antofagasta",
"description": "Vuelo LATAM LA128 • Clase Economy",
"options": "Equipaje de mano incluido",
"total_amount": {
"original_amount": 459900,
"amount": 459900,
"currency": "CLP",
"currency_symbol": "$"
},
"unit_price": {
"amount": 459900,
"currency": "CLP",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 0,
"currency": "CLP",
"currency_symbol": "$"
},
"quantity": 1,
"uom": "ticket",
"upc": "",
"sku": "TKT-SCL-ANF-ECON",
"isbn": "",
"brand": "LATAM",
"manufacturer": "",
"category": "Aereo",
"color": "",
"size": "",
"weight": {
"amount": 0,
"unit": "kg"
},
"image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/8a/LATAM_Airlines_logo.svg/512px-LATAM_Airlines_logo.svg.png",
"details_url": "",
"type": "service",
"taxable": true
}
],
"sub_total": 45990000,
"total_amount": 45990000,
"store_code": "all",
"billing_address": {
"address1": "Av. Apoquindo 3000",
"address2": "Oficina 1205",
"address_type": "office",
"city": "Santiago",
"country_code": "CL",
"email": "test_chile@testuser.com",
"first_name": "Juan",
"last_name": "Pérez",
"identity_document": "12.345.678-5",
"identity_document_type": "RUT",
"is_default": true,
"phone": "+56228901234",
"state_code": "RM",
"state_name": "Región Metropolitana",
"zipcode": "8320000"
},
"shipping_address": {
"address1": "Av. Apoquindo 3000",
"address2": "Oficina 1205",
"address_type": "office",
"city": "Santiago",
"country_code": "CL",
"email": "test_chile@testuser.com",
"first_name": "Juan",
"last_name": "Pérez",
"identity_document": "12.345.678-5",
"identity_document_type": "RUT",
"is_default": true,
"phone": "+56228901234",
"state_code": "RM",
"state_name": "Región Metropolitana",
"zipcode": "8320000"
}
}
}Considérations particulières et limites#
- Comme Transbank ne prend en charge que 26 caractères pour l'identification de la commande, nous allons transformer le
order_idparamètre pour répondre aux exigences. Par conséquent, vous pouvez voir un id différent de celui envoyé par DEUNA. - Le nombre de versements est validé par rapport au nombre maximum de versements convenu avec l'acquéreur.
- Pour utiliser l'autorisation, Capture (complète et partielle) et vide, vous devez être configuré dans Transbank pour fonctionner avec Captura diferida.
- Un paiement qui est AUTHORIZED peut être capturé.
- Une capture partielle peut être effectuée si nécessaire.
- Chaque paiement autorisé permet une capture partielle ou totale.
- Il est recommandé de capturer une commande dans les 5 jours suivant l'autorisation pour éviter son expiration.
- Un remboursement ne peut être demandé qu'après qu'un paiement ait atteint le CAPTURED ou PROCESSED status.
- Les remboursements ne peuvent pas dépasser le montant initial capturé, mais un ou plusieurs remboursements partiels du montant capturé peuvent être effectués.
- Plusieurs remboursements partiels peuvent être envoyés par commande.
- Un paiement ne peut être annulé (annulé) qu'après avoir atteint le AUTHORIZED status.
- L'annulation n'est plus possible une fois le paiement atteint le CAPTURED status.
- Une annulation complète (annulée) peut être envoyée par commande.