Token erstellen

post/merchants/{merchant_id}/token

Sie können einen Token mit beliebigen Benutzerparametern erstellen. Sie senden diese Parameter beim Abrufen des Tokens und erhalten sie nach erfolgreicher Zahlung zurück. Ein Token kann nur Parameter enthalten, die entweder in diesem Dokument beschrieben oder von Ihnen vordefiniert sind.

Wenn ein Parameter im falschen Format gesendet wird oder den falschen Typ hat, wird kein Token ausgegeben. Stattdessen erscheint der HTTP-Statuscode 204 samt Fehlerbeschreibung im JSON-Body. Unter extended_message ist exakt aufgeführt, welche Parameter fehlerhaft gesendet wurden.

Note

Diese API-Methode lässt sich unter hoher Last nicht verwenden. Bei einer hohen Anzahl von Anfragen können Ratenbegrenzungen greifen. Erkundigen Sie sich bei Ihrem Account Manager nach den Ratenbegrenzungen für diese API-Methode.

Request

Security:

basicAuth

path Parameters

merchant_id

required

integer

Händler-ID.

Request Body schema: application/json

Any of:

	object Sie können zusätzliche Parameter im Token im `custom_parameters` Objekt übergeben, um Betrugsschutzfilter zu konfigurieren. Die empfohlenen Parameter werden in der Dropdown-Liste angezeigt. Siehe Bezahlstation-Dokumentation.
	object Objekt, welches Angaben zum Kauf enthält.
	object Benutzerdefinierte Projekteinstellungen (Objekt).
	object Benutzerdaten (Objekt).

Responses

200

Created.

422

Unprocessable Entity.

Request samples

application/json

{"purchase": {"virtual_currency": {"quantity": 100
},
"virtual_items": {"items": [{"amount": 1,
"sku": "SKU01"
}
]
}
},
"settings": {"currency": "USD",
"language": "en",
"project_id": 16184,
"ui": {"components": {"virtual_currency": {"custom_amount": true
}
},
"desktop": {"virtual_item_list": {"button_with_price": true,
"layout": "list"
}
},
"size": "medium"
}
},
"user": {"age": 19,
"country": {"allow_modify": true,
"value": "US"
},
"email": {"value": "john.smith@mail.com"
},
"id": {"value": "user_2"
},
"name": {"value": "John Smith"
}
}
}

Response samples

application/json

{"token": "eop57k1boA7nnYPtewZ6KEXJyJADEwRT"
}