Creating PINs

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
	}
    }
}