---
title: "Generate Token [bulk]"
method: POST
path: "/cardless-service/api/v1/cardless-services/batch-token"
---

# Generate Token \[bulk\]

`POST /cardless-service/api/v1/cardless-services/batch-token`

## Request

- Base URL: `https://sandbox.interswitchng.com`
- URL: `https://sandbox.interswitchng.com/cardless-service/api/v1/cardless-services/batch-token`
- Auth: none required

## Headers

- `Content-Type` string
- `Authorization` string

## Request body

- object
  - `subscriberId` string, required: Customer ID. E.g. 2348012233220
  - `paymentMethodCode` string, required: A unique Identifier of payment instrument issuer e.g. GTMM, FBN
  - `frontEndPartnerId` string, required: A unique Identifier of App developer e.g. GTMM
  - `tokenLifeTimeInMinutes` string: The time this Paycode token should expire
  - `amount` string: Transaction amount. If payWithMobileChannel is ATM, this is Mandatory, if it is POS the purchase amount (the amount entered during transaction with Paycode) cannot be higher than this value
  - `ttid` string, required: Terminal Transaction ID. A unique generated id sent from the client application.
  - `oneTimePin` string: The one time PIN to be used to cashout Paycode at ATM. This value is Mandatory for ATM Cashout
  - `secure` string: This contains payment method code authorization information. This field is Mandatory if the payment method authenticated by PIN.
  - `transactionRef` string: Unique transaction reference. To be used as unique identifier in call to cancel token.
  - `additionalInfo` object
    - `type` string
  - `channel` string: Paycode channel. This can either be ATM, POS, Agent and WEB.
  - `pinBlock` string, required: This contains the encrypted payment method PIN. This field is Mandatory if the payment method is authenticated by PIN
  - `macData` string, required: This contains the MAC of some sensitive data. This field is Mandatory if the payment method is authenticated by PIN
  - `referenceId` string, required: Unique reference id. To be used as unique identifier to each bulk token generation request
  - `beneficiaryNumber` string, required: Mobile number of token beneficiary
  - `entries` unknown[], required: This array contains the amount, beneficiaryNumber and oneTimePin for each token
    - unknown
  - `batchSize` string, required: This shows the total number of token intended to generate. NB. Only a maximum of 10 token can be generated at a time.
  - `paymentMethodIdentifier` string, required
  - `defaultOneTimePin` string, required
  - `currency` string

## Response `200`

200

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/interswitchgroup/apis/ipg.md) - [All operations](https://skmtc.dev/interswitchgroup/apis/ipg/llms.txt) - [OpenAPI document](https://skmtc.dev/interswitchgroup/apis/ipg/revisions/98dead048190?raw)