Test Your Integration

Table of contents

1. Basic Test Card Numbers
2. Simulating Address Verification Responses
3. Simulating CVC Responses
4. Webhooks

Learn about the different methods to test your integration before going live.

This page includes test card numbers and other information to make sure your integration works as planned. Use it to trigger different flows in your integration and ensure they are handled accordingly.

This information only applies to the sandbox environment (i.e. https://sandbox-api.tilled.com).

Basic Test Card Numbers

* See Simulating CVC Responses

Simulating Address Verification Responses

By default, all card transactions with valid billing_details addresses will pass the address verification checks. To simulate a different response, add a single letter code from the table below as a prefix to the billing_details.street property. Example: billing_details.street='N 123 Main Street' will produce failed checks where no part of the address matches. These checks are available on the payment_method.card.checks property.

Example:

billing_details.street is prefixed with N and therefore the card.checks.address_**=fail

{
  "id": "pm_7jzakGs4bVgTo82EDLZcS",
  "type": "card",
  "card": {
    "brand": "visa",
    "last4": "1111",
    "checks": {
      "cvc_check": "pass",
      "address_line1_check": "fail",
      "address_postal_code_check": "fail"
    },
    "exp_year": 2026,
    "exp_month": 8
  },
  "billing_details": {
    "name": "John Doe",
    "address": { 
      "zip": "80302",
      "street": "N 123 Main Street", // Note the 'N' prefix
      "country": "US"
    }
  },
  ...
}

Simulating CVC Responses

Webhooks

To test your integration, perform actions using the API (in test mode) to send legitimate events to your endpoint. For instance, creating a charge triggers the charge.succeeded event that contains the charge data. You can then use the API to verify the resulting event data.