Transaction Check

Full Transaction check request body

{
  "transaction_id": "string",
  "type": "e9r-4wtF-3JJ5dTV4",
  "datetime": "2022-10-03T17:48:24.084133+01:00",
  "state": "created",
  "origin_user_id": "string",
  "origin_details": {
    "amount": "459991419461",
    "currency": "str",
    "country": "st"
  },
  "destination_user_id": "string",
  "destination_details": {
    "amount": "-16408265386210",
    "currency": "str",
    "country": "st"
  },
  
  // The "origin_payment_details" fields take the mode of transaction 
  "origin_payment_details": {
  // Card transaction
    "card": {
      "fingerprint": "string",
      "issued_country": "st",
      "transaction_reference_field": "string",
      "three_ds_done": false,
      "first_name": "string",
      "middle_name": "string",
      "last_name": "string",
      "expiry_month": "string",
      "expiry_year": "string",
      "last_four_digit": "stri",
      "brand": "visa",
      "funding": "credit",
      "authenticated": true
    },
    
    // Generic bank account
    "generic_bank_account": {
      "account_name": "string",
      "account_number": "string",
      "account_type": "string",
      "bank_name": "string",
      "bank_code": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "special_instructions": "string"
    },
    
    // IBAN transaction
    "iban": {
      "bic": "string",
      "iban": "string",
      "account_name": "string",
      "branch_code": "string",
      "bank_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    },
    
    // ACH transaction
    "ach": {
      "routing_number": "string",
      "bank_name": "string",
      "account_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "beneficiary_name": "string"
    },
    // SWIFT Transaction
    "swift": {
      "swift_code": "string",
      "account_number": "string",
      "account_name": "string",
      "account_type": "string",
      "bank_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "special_instructions": "string"
    },
    
    // MPESA Transaction
    "mpesa": {
      "business_short_code": "string",
      "transaction_type": "customer pay bill online",
      "phone_number": "string"
    },
    "upi": {
      "upi_id": "string",
      "bank_provider": "string",
      "interface_provider": "string",
      "account_name": "string"
    },
    "wallet": {
      "wallet_type": "string",
      "wallet_id": "string",
      "payment_channel": "string",
      "account_name": "string",
      "phone_number": "string",
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    }
  },
  // Destination payment details may also be sent with the request body
  // but not required
  "destination_payment_details": {
    // CARD Transaction
    "card": {
      "fingerprint": "string",
      "issued_country": "st",
      "transaction_reference_field": "string",
      "three_ds_done": false,
      "first_name": "string",
      "middle_name": "string",
      "last_name": "string",
      "expiry_month": "string",
      "expiry_year": "string",
      "last_four_digit": "stri",
      "brand": "visa",
      "funding": "credit",
      "authenticated": true
    },
    
    // Generic Bank Account
    "generic_bank_account": {
      "account_name": "string",
      "account_number": "string",
      "account_type": "string",
      "bank_name": "string",
      "bank_code": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "special_instructions": "string"
    },
    
    // IBAN Transaction
    "iban": {
      "bic": "string",
      "iban": "string",
      "account_name": "string",
      "branch_code": "string",
      "bank_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    },
    
    //ACH Transaction
    "ach": {
      "routing_number": "string",
      "bank_name": "string",
      "account_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "beneficiary_name": "string"
    },
    
    // SWIFT Transaction
    "swift": {
      "swift_code": "string",
      "account_number": "string",
      "account_name": "string",
      "account_type": "string",
      "bank_name": "string",
      "address_lines": [
        "string"
      ],
      "postcode": "string",
      "city": "string",
      "state": "string",
      "country": "st",
      "address_tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "special_instructions": "string"
    },
    
    // MPESA Transaction
    "mpesa": {
      "business_short_code": "string",
      "transaction_type": "customer pay bill online",
      "phone_number": "string"
    },
    "upi": {
      "upi_id": "string",
      "bank_provider": "string",
      "interface_provider": "string",
      "account_name": "string"
    },
    "wallet": {
      "wallet_type": "string",
      "wallet_id": "string",
      "payment_channel": "string",
      "account_name": "string",
      "phone_number": "string",
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    }
  },
  "product_type": "string",
  "promotion_code_used": false,
  "reference": "string",
  "device_data": {
    "battery_level": 0,
    "device_latitude": "string",
    "device_longitude": "string",
    "ip_address": "string",
    "device_identifier": "string",
    "vpn_used": false,
    "operating_system": "string",
    "device_maker": "string",
    "device_model": "string",
    "device_year": "string",
    "app_version": "string"
  },
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}

POST {{base_url}}/transactions/transaction-check/verify

Last updated