Before you’re able to use this process please contact sales@42com.com to generate a complete pin creation account for usage of the api!
You’ll get a username/password combination to use this process.
For all processes you need the cli paramter which is always named „Telefon“ during the processes.
Creating cards
Parameter: m „mycard-v2“
Parameter: act „insert“
Parameter: Telefon [country code e.g. +49 for Germany & mobile number e.g. 49179900000]
Parameter: Kunde name of the customer [could be the same like Telefon]
Parameter: Amount amount in EUR
Parameter: sendSmsInfo should the customer receive a sms?
Parameter: smsinfo_message text 4 the sms [if empty we’ll send a default template]
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'insert' (length=11) 'Kunde' => string '' (length=0) 'Telefon' => string '4917990000000' (length=12) 'Amount' => string '0.10' (length=1) 'sendSmsInfo' => string '1' (length=1)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": 1
}
}
}
Getting status of a cards
Parameter: m „mycard-v2“
Parameter: act „show“
Parameter: Telefon
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'show' (length=11) 'Telefon' => string '4917990000000' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": 1
}
}
}
If „active“ is empty, the card is blocked!
Blocking cards
Parameter: m „mycard-v2“
Parameter: act „blockcard“
Parameter: Telefon
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'blockcard' (length=11) 'Telefon' => string '4917990000000' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": ''
}
}
}
Un-Blocking cards
Parameter: m „mycard-v2“
Parameter: act „unblockcard“
Parameter: Telefon
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'unblockcard' (length=11) 'Telefon' => string '4917990000000' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": 1
}
}
}
Disable Cards
Parameter: m „mycard-v2“
Parameter: act „disableCliByNumber“
Parameter: realm
Parameter: cli Telefon
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'disableCliByNumber' (length=11) 'realm' => string 'testRealm' (length=50) 'cli' => string '4917990000000' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": ' '
}
}
}
Change CLI
Parameter: m „mycard-v2“
Parameter: act „changeCliByNumber“
Parameter: realm
Parameter: cli Current telefon
Parameter: newCli New telefon
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'changeCliByNumber' (length=11) 'realm' => string 'testRealm' (length=50) 'cli' => string '4917990000000' (length=12) 'newCli' => string '4917990000001' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000001",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": 1
}
}
}
Activate Cards
Parameter: m „mycard-v2“
Parameter: act „activateMyCard“
Parameter: realm
Parameter: cli Telefon
Parameter: PIN „321582778“
Request:
'm' => string 'mycard-v2' (length=9) 'v' => string 'json' (length=4) 'act' => string 'activateMyCard' (length=11) 'realm' => string 'testRealm' (length=50) 'cli' => string '4917990000000' (length=12) 'PIN' => string '321582778' (length=12)
Response Body:
{
"error": false,
"codes": [
{
"code": 200,
"description": "OK"
}
],
"body": {
"Kunde": "4917990000000",
"CLI": "4917990000000",
"Amount": "0,10 EUR",
"AmountAll": "0,10 EUR",
"fldSerial": "12871384",
"fldPIN": "321582778",
"active": 1
}
}
}