On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/echeck/user/all/rest/echeck-user-guide/echeck-api-intro/echeck-api-cre-token-standalone.md)  
Filter  
FILTER BY TAG

Creating an eCheck Token Using the REST API {#echeck-api-cre-token-standalone}
==============================================================================

This section shows how to create an eCheck token for your customer using the REST API.

> IMPORTANT No transaction is run in this use case. The token is created for future use with this customer.

Creating a Customer Token With No Payment Details
-------------------------------------------------

Follow these steps to create an eCheck token for your customer using your customer's bank account details:

1. Create the message with the required API fields.
2. Send the message to one of these endpoints:
   * Production: `POST ``https://api.cybersource.com``/tms/v2/customers`
   * Test: `POST ``https://apitest.cybersource.com``/tms/v2/customers`
3. Verify the response messages to make sure that the request was successful. A 200-level HTTP response code indicates success. See [Transaction Response Codes](https://developer.cybersource.com/api/reference/response-codes.md "").

Required Fields for Creating an eCheck Token {#echeck-api-cre-token-standalone-req-fields}
==========================================================================================

[paymentInstrument.bankAccount.type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/payment-instrmnt-bank-accnt-type.md "")
:

[paymentInstrument.instrumentIdentifier.bankAccount.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/payment-instrmnt-instrmnt-id-bank-accnt-num.md "")
:

[paymentInstrument.instrumentIdentifier.bankAccount.routingNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/payment-instrmnt-instrmnt-id-bank-accnt-rout-num.md "")
:

REST Example: Creating an eCheck Token {#echeck-api-cre-token-standalone-example}
=================================================================================

Request

```
{
    "paymentInstrument": {
        "bankAccount": {
            "type": "savings"
        },
        "instrumentIdentifier": {
            "bankAccount": {
                "number": "12345678901234567",
                "routingNumber": "071923284"
            }
        }
    }
}
```

Response

```
{
     "_links": {
        "self": {
            "href": "/tms/v2/customers/2281788029E0D2B4E0633F36CF0AB40D"
        },
        "paymentInstruments": {
            "href": "/tms/v2/customers/2281788029E0D2B4E0633F36CF0AB40D/payment-instruments"
        },
        "shippingAddresses": {
            "href": "/tms/v2/customers/2281788029E0D2B4E0633F36CF0AB40D/shipping-addresses"
        }
    },
    "id": "2281788029E0D2B4E0633F36CF0AB40D",
    "objectInformation": {
        "title": "subscription_title",
        "comment": "comments"
    },
    "buyerInformation": {
        "merchantCustomerID": "customer_account_id"
    },
    "clientReferenceInformation": {
        "code": "merchant_ref_number"
    },
    "merchantDefinedInformation": [
        {
            "name": "data1",
            "value": "merchant_defined_data1"
        },
        {
            "name": "data2",
            "value": "merchant_defined_data2"
        },
        {
            "name": "data3",
            "value": "merchant_defined_data3"
        },
        {
            "name": "data4",
            "value": "merchant_defined_data4"
        },
        {
            "name": "sensitive1",
            "value": "merchant_secure_data1"
        },
        {
            "name": "sensitive2",
            "value": "merchant_secure_data2"
        },
        {
            "name": "sensitive3",
            "value": "merchant_secure_data3"
        },
        {
            "name": "sensitive4",
            "value": "merchant_secure_data4"
        }
    ],
    "metadata": {
        "creator": "npr_fnbo"
    }
}
```

RELATED TO THIS PAGE