# Tilopay.Init()
> Starts a purchase: authenticates the checkout and returns the environment, the available payment methods and the customer's saved cards.
- kind: sdk-method
- status: stable
- sdk_version: 2.1.1
- last_verified: 2026-10-22
- url: https://tilopay.com/en/developers/sdk/reference/init
Starts a purchase. It authenticates the checkout with the SDK token and returns the payment
methods available to you.
To save a card without charging it, use
[`Tilopay.InitTokenize()`](/en/developers/sdk/reference/init-tokenize).
## Signature [#firma]
```js
await Tilopay.Init({ /* parameters */ })
```
## Parameters [#parametros]
URL where Tilopay notifies the outcome of SINPE Móvil and Yappy payments.
SDK token, obtained by your backend with `POST /api/v1/loginSdk`. See
[SDK token](/en/developers/api/autenticacion/token-sdk).
Purchase currency, ISO 4217.
Checkout language: `es` or `en`.
Purchase amount.
Customer email. Needed for the response to include saved cards.
Order number. **It cannot be repeated.** See
[safe retries](/en/developers/reintentos-seguros).
Customer identification type. Required for SINPE Móvil. See the
[type table](/en/developers/sdk/reference/update-options#tipos-de-identificacion).
Customer identification number. Required for SINPE Móvil.
Customer first name.
Customer last name.
Customer address line 1.
Customer address line 2.
City.
State or province.
Postal code.
Country, ISO 3166-1 alpha-2.
Customer phone.
Shipping recipient first name.
Shipping recipient last name.
Shipping address line 1.
Shipping address line 2.
Shipping city.
Shipping state or province.
Shipping postal code.
Shipping country, ISO 3166-1 alpha-2.
Shipping phone.
`0` authorizes; `1` authorizes and captures.
URL where the SDK renders the final purchase response.
`1` saves the customer card in Tilopay; `0` does not save it.
Values `"V1"` or `"V2"`. If omitted, the final response hash is built with **V2**. It is
sent in this first call.
Returned as-is in the final payment response and recovered on the transaction
response URL. Supports up to **65,535 characters**, although a very long value can affect
the response URL. You can send a base64-serialized array so it satisfies the string format.
Yappy phone. Required when paying with Yappy. It is not read from the DOM.
## Call [#llamada]
```js
const init = await Tilopay.Init({
token: "",
currency: "CRC",
language: "es",
amount: 100.0,
billToEmail: "cliente@ejemplo.com",
orderNumber: "ORD-2026-000123",
billToFirstName: "Ana",
billToLastName: "Rojas",
billToCountry: "CR",
capture: 1,
redirect: "https://ejemplo.com/respuesta",
subscription: 0,
});
```
## Response [#respuesta]
```json
{
"message": "Success",
"environment": "PROD",
"sinpemovil": { "code": "TB095", "amount": "100.00" },
"methods": [
{ "id": "", "name": "Tarjeta", "type": "card", "apple_pay": 0 },
{ "id": "", "name": "SINPE Móvil", "type": "sinpemovil", "apple_pay": 0 }
],
"cards": [
{ "id": "411112555451111:Ref", "name": "4111********1111", "brand": "visa" }
],
"applePaySupported": false
}
```
`Success`, or the error description.
`"PROD"` production, `"TEST"` testing. See [environments](/en/developers/entornos).
Object with `code` and `amount`, present when you have SINPE Móvil. The full data,
including the destination phone, is obtained with
[`getSinpeMovil()`](/en/developers/sdk/reference/get-sinpe-movil).
Array of `{id, name, type, apple_pay}` with available methods. `type` is `card`, `sinpemovil` or `yappy`; every method includes `apple_pay` (`0` or `1`).
Array of `{id, name, brand}` with the customer's saved cards.
`true` when the [Apple Pay](/en/developers/sdk/apple-pay) requirements are met for that domain
and browser.
### On error [#respuesta-de-error]
On error:
```json
{
"message": "",
"methods": [],
"cards": []
}
```
## Payment method id format [#formato-id-metodo]
Do not interpret the id: store it as-is as the select value and use each method's `type` field
(`card`, `sinpemovil` or `yappy`) to decide which fields to show.
## Yappy [#yappy]
The method has `type: "yappy"`; its id has the form `:18::…`.
The form needs the required `Init()` fields plus `phoneYappy`. Calling `startPayment()` redirects to a Tilopay page that opens Yappy; the customer approves in their app. When finished, Tilopay notifies `webhook` (if provided) and redirects to your `redirect` with `code`, `auth`, `order` and `OrderHash`. Cancellation rejects the order; without a response within **7 minutes**, it becomes “Transaction expired”.
## Saved cards [#tarjetas-guardadas]
- For the response to include `cards`, **`billToEmail` is required**.
- Once the cards are obtained, **the email can no longer be changed** with
[`updateOptions()`](/en/developers/sdk/reference/update-options).
- The customer can pick a saved card or type a new one.
- When a saved card is picked, **enable `tlpy_cvv`** so the customer can type the code.