API Explorer
Client Login

Create a credit card

post
http://<host-url>/bl-integration/card

Create a credit card in Banking Live

Body Params
int32
required

Existing account number. New card will be linked to this account.

int32
required
1 to 2

1 = Physical card, 2 = Virtual card

image_fields
object
string
required

Image template name for the card to be generated. This field is case sensitive. card image has to be populated as configured in PayControl.

int32
required
≥ 1

card product id. (Need to input correct product id for your card so it will inherit full required properties and be fully linked with business.)

int32
required
≤ 32767

Status network :

1000 : Fully operational DE39=00

1001 : Refer to issuer DE39=01

1004 : Capture card DE39=04

1005 : Decline all txns DE39=05

1008 : Honour with ID DE39=08

1041 : Lost card - capture DE39=41

1043 : Stolen card - capture DE39=43

1054 : Expired card - report DE39=54

1140 : Lost Card - NO Capture

1143 : Stolen card - NO Capture

1154 : Expire card - don't inform

1062 : Restricted card

int32
required
1 to 5

How to deliver image back to client.

1==> Image in plain base64, encrypted pan, cvv,token,expiry,emboss_name).

2 ==> Image in byte encrypted ,encrypted pan, cvv,token,expiry,emboss_name.

3 ==> Data details JSON (encrypted pan,cvv,token,expiry,emboss_name but no image.

4 ==> Image in byte encrypted , masked pan back, cvv,token,expiry,emboss_name.

xml_fields
object
int32
≤ 32767

Card manufacturer ID. If not passed, the default manufacturer ID will be taken from the manufacturer table

string
length between 0 and 30

Name that appears in front of the card

string
length between 0 and 32

Flags for token to assign various tasks to the card

string
length between 0 and 50

Optional client provided reference

string
length between 0 and 60

Product identifier, i.e. physical card design reference used by the card printer

string

Expiry Date in format yyyy-mm-dd hh:mm:ss

string
length between 0 and 10

Card holder title

string
length between 0 and 50

Card holder first name

string
length between 0 and 50

Card holder surname

string
length between 0 and 100

Card holder address line 1

string
length between 0 and 100

Card holder address line 2

string
length between 0 and 15

Card holder postal code

string
length between 0 and 50

Card holder city

string
length between 0 and 50

Card holder country

string
length between 0 and 60

Card holder language region

string
length between 0 and 50

Card holder/customer reference

string

Card holder date of birth in format yyyy-mm-dd

string
length between 0 and 10

Delivery title

string
length between 0 and 50

Delivery first name

string
length between 0 and 50

Delivery surname

string
length between 0 and 100

Delivery address line 1

string
length between 0 and 100

Delivery address line 2

string
length between 0 and 20

Delivery postal code

string
length between 0 and 50

Delivery city

string
length between 0 and 50

Delivery country

string
length between 0 and 60

Delivery email

string
length between 0 and 20

Delivery mobile number in format 00 (country code) phone number or + (country code) phone number

string
length between 0 and 10

Delivery passcode

int32

Delivery method for card: 0 – Standard mail, 1 – Registered mail, 2 – Direct delivery (courier) RFU

int64

Delivery account number

string
length between 0 and 50

Delivery language

int32

Bulk delivery address code set by bank

int32
≤ 1

Purchaser customer type determining the single delivery of a card to a specific address. 0: Card will be delivered to card holder address, 1: Card will be delivered to purchaser address

int32

Delivery code, carriers with the same del_code will be grouped for sending to a specified delivery address

string
length between 0 and 2

Language used in ATM

string

Carrier type for shipment to the customer

int32
≤ 32767

Identifies insert 1 to be included with carrier in the envelope

int32
≤ 32767

Identifies insert 2 to be included with carrier in the envelope

string
length between 0 and 3

Language used in carrier notes and labels (ISO 3166-1, three characters)

int32
≤ 32767

Identifies envelope type

string
length between 0 and 20

Extra card text line 1

string
length between 0 and 50

User ID of the customer who triggered the API request

string
length between 0 and 20

Extra card text line 2

string
length between 0 and 200

Remarks for API request

string
length between 0 and 255

Customer special details

string
length between 0 and 35

Emboss line 4

string
length between 0 and 50

Track 3, mag stripe

string
length between 0 and 50

Future field 1 RFU

string
length between 0 and 50

Future field 2 RFU

string

Associates group ID with the account

string
length between 0 and 50

Instruction for the card

string
length between 1 and 1

Authorization Type: 0=>Internal, 1=>External, 2=>Notification

string
length between 0 and 50

2-digit ISO (639.2) language code

string
length between 5 and 5

Configuration for sensitive data

string

ISO 639-1 two-letter language code.

3ds_challenge_methods
array of objects
3ds_challenge_methods
string

Unique identifier for the challenge profile

string

Token group ID

Headers
int32
required

Client identifier provided by Paymentology

string

Unique identifier of a request.

Responses

Updated 7 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*

Updated 7 months ago