4. Refund a transaction

DELETE

/v1/refund/{{ticketNumber}}

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request DELETE '/v1/refund/{{ticketNumber}}' \
--header 'Private-Merchant-Id: {{MX-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "fullResponse": "v2",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 927,
    "ice": 0,
    "iva": 0,
    "currency": "MXN"
  }
}'

Response Example

201 - 201 - fullResponse true

{
    "ticketNumber": "661650897232864278",
    "details": {
        "acquirerBank": "BANJERCITO",
        "saleTicketNumber": "291362318331970549",
        "integrationMethod": null,
        "processorName": "Elavon Processor",
        "paymentBrand": "Master Card",
        "socialReason": "Merchant MX",
        "cardType": "credit",
        "currencyCode": "MXN",
        "country": "Mexico",
        "responseCode": "000",
        "categoryMerchant": null,
        "publicCredentialId": "295f9dea62f64d55acc873ebd8e87c5d",
        "subtotalIva": 0,
        "taxId": "1234567890123",
        "security": {
            "whitelist": false
        },
        "plcc": false,
        "lastFourDigits": "5480",
        "syncMode": "online",
        "merchantName": "Merchant MX",
        "credentialAlias": "Merchant MX",
        "productDetails": {
            "product": [
                {
                    "id": "198952AB",
                    "quantity": 1,
                    "title": "eBook Digital Services",
                    "sku": "10101042",
                    "price": 500
                },
                {
                    "id": "198953AB",
                    "quantity": 1,
                    "title": "eBook Virtual Selling",
                    "sku": "004834GQ",
                    "price": 500
                }
            ]
        },
        "subtotalIva0": 1000,
        "maskedCardNumber": "545195XXXXXX5480",
        "merchantId": "20000000104111374000",
        "approvedTransactionAmount": 1000,
        "metadata": {
            "contractID": "157AB"
        },
        "responseText": "Transacción aprobada",
        "transactionId": "1650897232861071414",
        "fullResponse": true,
        "binCard": "545195",
        "ivaValue": 0,
        "iceValue": 0,
        "issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
        "token": "76af9ea428ab4c158812ce3b0a0d3242",
        "foreignCard": true,
        "contactDetails": {
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "+593912345678",
            "documentType": "CURP",
            "documentNumber": "DORJ760623HNGDORJ7",
            "email": "user@example.com"
        },
        "processorId": "1000001041103567878316507278003",
        "requestAmount": 1000,
        "cardHolderName": "John Doe",
        "userAgent": "PostmanRuntime/7.29.0",
        "ip": "186.28.11.9",
        "transactionStatus": "INITIALIZED",
        "processorType": "gateway",
        "created": 1650897233000,
        "approvalCode": "000000",
        "tokenType": "transaction-token",
        "processorMerchantId": "543210",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "credentialId": "04b1d39627954fb1a550d86fde29d2eb",
        "transactionType": "VOID",
        "orderDetails": {
            "shippingDetails": {
                "zipcode": "170402",
                "country": "México",
                "phone": "+593912345678",
                "address2": "centro 123",
                "city": "Querétaro",
                "address1": "Eloy Alfaro 139 y Catalina Aldaz",
                "name": "John Doe",
                "region": "Centro"
            },
            "billingDetails": {
                "country": "México",
                "zipCode": "170402",
                "phone": "+593912345678",
                "address2": "centro 123",
                "city": "Querétaro",
                "address1": "Eloy Alfaro 139 y Catalina Aldaz",
                "name": "John Doe",
                "region": "Centro"
            },
            "siteDomain": "example.com"
        },
        "transactionReference": "f1ccba6f-649f-4909-9f9e-35d53c8eb4ef",
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        }
    }
}

Modified at 2026-01-06 19:33:02

3. Void a transaction

5. Request deferred options