Payment Methods

When a payment method is entered into Tilled.js, the raw data passes directly into our vault, and Tilled.js returns a payment token to be passed in a call to our API. Tilled’s documentation may use the terms “vault” and “tokenize” interchangeably. A vaulted payment method will not persist in our system unless it has been attached to a customer. Please see the question below for more information.

When a payment method is created, a created_at and expires_at value will be provided in the response.

A card has a 5-minute validity period, while an ach_debit has a 15-minute validity period. However, payment methods will not expire once they have been attached to a customer, allowing them to be reused in multiple payment intents.

At the moment, only USD and CAD.

You must create a payment intent with the capture method set to manual to first create a payment intent with a status of requires_capture. From there, you capture it with the Capture a PaymentIntent endpoint.

A customer created at the partner level may use a previously saved payment with any of your merchants.

When you create a customer or make any calls to the payment method endpoints, you must include your partner account id in the header parameters. However, creating payment intents at the partner level is not possible with Tilled, regardless of how or where the payment method was created.

For code examples please see the PaymentRequest on Tilled.js.

You will not register the merchant using your Apple Developer account. We manage the process on our end when you utilize our Domain Verification File. Please follow the steps below to successfully create an Apple Pay domain for Tilled verification on Tilled:

1. You'll need an HTTPS-secured domain.
2. Add Tilled’s Apple Domain Verification File to the /.well-known/apple-developer-merchantid-domain-association path to your domain.
3. POST /v1/apple-pay-domains with your domain hostname: Example: "hostname": "https://example.com”
4. You should be able to proceed with the rest of the Apple Pay integration with Tilled.

For code examples please see the PaymentRequest on Tilled.js.

The Tilled.js API Documentation describes how to include a payment form in a partner's application. Tilled also offers a Simple Payment Example that incorporates Tilled.js into a website. You can see an example here.

The form method returns a promise rather than a form object. The browser engine is attempting to run createField before the promise has been fulfilled. Therefore, the method is not defined within the call's execution context. Before you can access the form object's methods, you must await the call's return value.

Yes, we offer a JavaScript library for tokenizing payments. For more information , see Tilled.js.

Tilled.js allows users to listen for and handle multiple events with the on method. Ex: field.on(event, handler): void. The on method supports the following events:

• change: triggered when the Form Field’s value changes.
• ready: triggered when the Form Field is fully rendered and can accept input.
• focus: triggered when the Form Field gains focus.
• blur: triggered when the Form Field loses focus.

Yes, Tilled offers a working example called the React Payment Example. It makes use of the Create React App SDK for the frontend and Node.js for the backend. More code samples are available in the Tilled Example Monorepo.