Create a Payment Customer

The API endpoint to create a Payment Customer is POST https://connect.secucard.com/api/v2/Payment/Customers.

Example Request

POST /api/v2/Payment/Customers HTTP/1.1
Host: connect-testing.secupay-ag.de
Authorization: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Content-Type: application/json
Accept: application/json
 
{
    "contact": {
        "salutation": "Mr.",
        "forename": "Max",
        "surname": "Mustermann",
        "address": {
            "street": "Max-Muster-Str.",
            "street_number": "25a",
            "postal_code": "09555",
            "city": "Musterstadt",
            "country": "DE",
            "additional_address_data": "Whg. 202"
        },
        "email": "mmustermann@example.net",
        "mobile": "+49 177 5555555",
        "phone": "+49 555 5555555"
    }
}

If everything is fine, the API responds with 200 OK:

Example Response

HTTP/1.1 200 OK
Content-Type: application/json
...
 
{
    "object": "payment.customers",
    "id": "PCU_38RG7MHRE2NJTPFMXRYQP3NKW6GVAZ",
    "merchant": {
        "object": "general.merchants",
        "id": "MRC_DNUWH3RE6J6TNRGW0X607S294W0XO3"
    },
    "contact": {
        "salutation": "Mr.",
        "forename": "Max",
        "surname": "Mustermann",
        "address": {
            "street": "Max-Muster-Str.",
            "street_number": "25a",
            "postal_code": "09555",
            "city": "Musterstadt",
            "country": "DE",
            "additional_address_data": "Whg. 202"
        },
        "email": "mmustermann@example.net",
        "mobile": "+49 177 5555555",
        "phone": "+49 555 5555555"
    }
}

The most important field is id. It identifies this particular Payment Customer object. You will need it to create a Payment Container, and to authorize the payment.