SPEI OPM

This page provides a guide to integrate SPEI OPM with DEUNA.

Supported Operations

SPEI OPM integration in your payment strategy with DEUNA allows you to perform the following operations:

Purchase
Partial refund
Full refund

📘
Make sure your account is properly configured on the SPEI OPM side

Supported Payment Methods

APM: Transfer

Active countries and currencies

Mexico (MXN)

Requirements

Contact your DEUNA representative and request the following credentials:

Your SPEI OPM credential

📘
Make sure your account is properly configured on the SPEI OPM side.

Integrate SPEI OPM

Integrate SPEI OPM.

1. Look for SPEI OPM in your connections

Search for SPEI OPM in Connections.

In Connections, a window like the following will open:

2. Configure SPEI OPM in your store

Enter the following credentials:
- In Name enter a name to reference the credential.
- In Currency select the Currency of Merchant Processor available.
- In API Key enter the SPEI OPM’s API key.
- In Private Key enter the SPEI OPM’s private key.
- In Bank Code enter the SPEI OPM’s bank code.
- In Branch Code enter the SPEI OPM’s branch code.
- In Integrator Code enter the SPEI OPM’s integrator code.
- In Cost Center enter the SPEI OPM’s cost center.
- In Expiration Time enter the SPEI OPM’s expiration time in minutes.
Click Connect.

Once you complete the steps, you will see a success message.

3. Process transactions with SPEIM OPM

You will see the SPEI OPM connection within the Active Connections tab.

From this point on, you can now process transactions with SPEI OPM through DEUNA.

Purchase v2 Example

{
    "payer_info": {
        "email": "[email protected]"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "bank_transfer",
        "processor": "spei_opm"
    },
    "order": {
        "order_id": "99f4e588-42eb-41dc-a3ba-d10ccd4f6ae2",
        "currency": "MXN",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "[email protected]",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zipcode": "11510",
            "city": "MIGUEL HIDALGO",
            "state_code": "{{state_code}}",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Special considerations and limitations

Currency Code: Specifies the currency (ISO 4217) code for the relevant country.
Country Code: Specifies the ISO Country Codes
Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
Only one partial refund can be sent per order.
An order is EXPIRED when the time configured in the connection has concluded.
The external_transaction_id field corresponds to the CLABE number of the account where the payment will be made.
Before taking payments in Latin America a legal entity and an acquirer in the country of operation are required

Testing Resources

SPEI OPM credentials

Moneda *
MXN

Api Key *
4661374d61089f7a8714847ac8bdf71006a77997f1826a85f7deed26d6348fd8

Llave Privada *
LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFdkFJQkFEQU5CZ2txaGtpRzl3MEJBUUVGQUFTQ0JLWXdnZ1NpQWdFQUFvSUJBUUNMMW5jV3lPRTlONGRjVXlDTkRjT1hVUmNyQ1c4bWdSNmFSRDdDOE4vc0V5UTBpMnZlNmNZUG1RTzZKU1NweWJQNlBSWnVubldFcWxJN2VHdmd1N09QdWMxL2hZMzNKb0FWSlJxMjRVU2hDY1YyNG5tem5FcnU2aU9acUVIamh4K1hIZmpCSGhTUXJGTVd1dkl5a3RFR0FtckdiREdWOWszNTQwVUEraHpRNzlNTU9taVJhZ2E4WmQwc3RnK3Y0M1phU0JFb21nQ0pPWVM3VnlBSkgyb2lhM1NXMXVxd2c4Y0lKMm0rQmNEUnZER2tCVERzTHQwQTkzcmZ4Qzc1aU1XRjN0dkxrNHdFTm42cXJ4K1dtQ1JkVkN3VFpZVkdJei9ab1U4WEk4bm0xTUN5WW0vT0RBdElTdWpSMUx2anVZUmJWLzBKWUVjSUN4ZkMrb2tnWi9xRkFnTUJBQUVDZ2dFQU94a0RNV1RxRkFZUXRjc0gyYlQwY1ZHNitkdzkxa2NCV083NG0waFRTaUQ0enlBUkVaODRya1RibDJLMU1QQm1tSjRTaWVOOEJQbzZVSm5lOVpZK0Y4TE5mMVJCSUM5c09BTjdXOGl1U1dTb3lFcUVab3pwK2ppSG5Sdkg1TkdwWHlNeWl1TWNpOXZZTGFZS1Q2ZE9vVHlLUlp0YUJXZVhvc0VTMjR2WWU5QU5TejU3dXQ3NHJsL0g1WTNQaVdzeUtjV096REJsdm9lOWZLZmJQbkJvNFZlbjU0cGtxQXhvbXVBKzNTS3dMbDJSVHZRaldIVzA1ME9XYjliU2NoWnBqaFFUUTB4dHVValNWSlhJR0hjTjBWNm5rTmxsV0NkM0gzZi9KWmF4NmgydEJkUnR3R2hyWUtqU1BrdmI2eEtEbzQvSFNTc3BqNVhDcGZLUitYeDJZUUtCZ1FEY3g5bjR4bWRtcVNncHdTeFNIblZRQkpCYngxa1FDN2ZnVEdMUGNPSy9ybERBMUZKeFZHV1RmdW9vaUlXbGFUYUExc29KcUgwWnlPMkFmYmFYLzJMNmZXS3pvZVB6bWtKTG5odUdVdmNDM0NvWEIxb2drNEk3Nmg1NFNEeDhqeHJoNklZMWVGa01GeElxVXhCcWNKelNWRlZGS0xwbEM3RWM5anJaT2oxUnZRS0JnUUNpSlJuU1EydUVnbnZwZy9xYXZTSVE5Tk84cGFyck8xS3JlMmtiMThRNERDZG9xenRlelF2Ky9ObS9rSm8wdmhYNzliOXFqQXdTUmdUWGZ4ZUJOZ1BiUnhBTWpRZitlZlVnay80d3hXcWgyMEowenMrUCtpSTFzeW5KbXA0MnlyTzJsaWtoNnFXSUxpUldOT3BTcVQ1ZXNXRjM2dFJaWlphQ1Z3Nmo5MHlFYVFLQmdFUzVNUEJ2VWVCeTV6MllFK083OTJoaEEwNk9UdnJmcXV6MjJnc1lhSHlpRmlEdjlubXdlNjNkNDZXYVdYK1RzSk9LU0htWktOZk40NkFMZ2JydWxEREV0dVNUa0JGVUF5N21tRXJIcUh3TGJFNmV5ejg0cTJGYkR3RUIrMUlLZWFPNGJZNVhWK0NiamR2KzN5MUN3STM0RWxMa3lxQ0pjeWhBdlREQklEVkJBb0dBWE5jcmVzWlp5TXpCMElwZU1yMjZ4TVM2ZkJqTHpkYncxZmxhekxOMXliWEQxdDI4cCtKMlRQRlFhS3lPYjBhcjVkSG5ZVVdCSC9GeGtrWldHZ2pvbW1TTkh2S2RzaXI0blVlLzB3TW10RGlNUzcraS8waDAwQlNmQjYxOWk5ZnlvTWhJRXdCOCtZV2FEclpMdVRybzJHVnVickJLR0VuZnJRL1Y5VEtEWUlrQ2dZQTdiR25FbzlndDRrVHBMeEQ3a2xNejFoMXVyOGFHK2Y2SmNVbHNGRkFETGhjZzZtOU82NXdDdE11elNvVHFoVzAyRkZCTWtBYmxodGRzWlNrbkxDZzlpWGFZNVY0OUtOWVU4Z0psNDNqYUtVd0N1U25VZXQzN21aM3lRc2xuSXZLYU05ckcvWWhnUmIrNjhyaXRCMkJncm1WdUFpTlhRUzloWTNKOWNEQ3Uzdz09Ci0tLS0tRU5EIFJTQSBQUklWQVRFIEtFWS0tLS0tCg==

Código de banco *
684

Código de sucursal *
180

Código de integrador *
250

Código de centro de costo *
001

Tiempo de expiración *
4320

Postman collection

SPEI OPM Collection.json