Zahlungsmethoden
Listen Sie Zahlungsmethoden auf, fügen Sie diese hinzu, setzen Sie eine Standardmethode und entfernen Sie Zahlungsmethoden über die Talkturo API — verwalten Sie Stripe-basierte Karten für Workspace-Abrechnung und Guthabenkäufe.
curl -X GET "https://app.talkturo.com/api/payment-methods?accountId=acc_9f3a2b1c" \
-H "Authorization: Bearer tk_example_9xmk7q2r"
{
"success": true,
"paymentMethods": [
{
"id": "c8b2b7d3-6df5-4d0f-8d18-2e23ef9df4f1",
"stripe_payment_method_id": "pm_1Qp7K2ABCD3EfghI9jKlmnOp",
"type": "card",
"card_brand": "visa",
"card_last4": "4242",
"card_exp_month": 12,
"card_exp_year": 2028,
"card_funding": "credit",
"is_default": true,
"is_active": true,
"billing_details": {
"name": "Jane Chen",
"email": "jane@acme.com"
},
"created_at": "2025-02-14T10:21:33.000Z"
}
],
"count": 1
}
{
"success": false,
"error": "accountId is required"
}
curl -X POST "https://app.talkturo.com/api/payment-methods" \
-H "Authorization: Bearer tk_example_9xmk7q2r" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_9f3a2b1c",
"paymentMethodId": "pm_1Qp7K2ABCD3EfghI9jKlmnOp",
"setAsDefault": true
}'
{
"success": true,
"paymentMethod": {
"id": "c8b2b7d3-6df5-4d0f-8d18-2e23ef9df4f1",
"stripe_payment_method_id": "pm_1Qp7K2ABCD3EfghI9jKlmnOp",
"card_brand": "visa",
"card_last4": "4242",
"card_exp_month": 12,
"card_exp_year": 2028,
"is_default": true
}
}
{
"success": false,
"error": "accountId and paymentMethodId are required"
}
curl -X DELETE "https://app.talkturo.com/api/payment-methods/c8b2b7d3-6df5-4d0f-8d18-2e23ef9df4f1" \
-H "Authorization: Bearer tk_example_9xmk7q2r"
{
"success": true,
"message": "Payment method deleted"
}
{
"success": false,
"error": "Payment method not found"
}
curl -X PATCH "https://app.talkturo.com/api/payment-methods/c8b2b7d3-6df5-4d0f-8d18-2e23ef9df4f1" \
-H "Authorization: Bearer tk_example_9xmk7q2r" \
-H "Content-Type: application/json"
{
"success": true,
"message": "Default payment method updated"
}
{
"success": false,
"error": "Payment method not found"
}
Verwaltung von Zahlungsmethoden
Verwalten Sie gespeicherte Zahlungsmethoden für Workspace-Abrechnung und Guthabenkäufe über die Talkturo API. Diese Endpunkte arbeiten mit Stripe-basierten Karten und unterstützen Session-Cookies oder API-Schlüssel über withApiAuth.
Base URL: https://app.talkturo.com
Authentifizierung: Session-Cookie oder Authorization: Bearer tk_...
Endpunkte
Zahlungsmethoden auflisten
Rufen Sie alle aktiven und gespeicherten Zahlungsmethoden für einen Workspace ab.
Anfrageparameter
Workspace-ID. Bei API-Schlüsseln ist dieser Wert optional, wenn der Schlüssel bereits an den Workspace gebunden ist.
Antwortfelder
Gibt an, ob die Anfrage erfolgreich war.
Liste der gespeicherten Zahlungsmethoden des Workspace.
Anzahl der zurückgegebenen Zahlungsmethoden.
Objekte in paymentMethods
Interne UUID der Zahlungsmethode in Talkturo.
Stripe-ID der Zahlungsmethode, in der Regel beginnend mit pm_.
Typ der Zahlungsmethode. Für diese Endpunkte ist dies typischerweise card.
Kartenmarke, zum Beispiel visa oder mastercard.
Die letzten vier Ziffern der Karte.
Ablaufmonat der Karte.
Ablaufjahr der Karte.
Finanzierungsart der Karte, zum Beispiel credit oder debit.
Gibt an, ob diese Zahlungsmethode aktuell die Standardmethode ist.
Gibt an, ob die Zahlungsmethode aktiv verwendet werden kann.
Abrechnungsdetails, die von Stripe für die Zahlungsmethode gespeichert wurden.
Zeitpunkt der Erstellung im ISO-8601-Format.
Zahlungsmethode hinzufügen
Fügen Sie einem Workspace eine neue Stripe-Zahlungsmethode hinzu. Optional können Sie die neue Methode sofort als Standard festlegen.
Anfrage-Body
Workspace-ID, zu der die Zahlungsmethode hinzugefügt wird.
Stripe-ID der Zahlungsmethode. Verwenden Sie eine gültige ID, die mit pm_ beginnt.
Legt fest, ob die neue Zahlungsmethode direkt als Standard gesetzt wird. Standardwert ist false.
Antwortfelder
Gibt an, ob die Zahlungsmethode erfolgreich hinzugefügt wurde.
Die neu gespeicherte Zahlungsmethode.
Interne UUID der neu erstellten Zahlungsmethode.
Stripe-ID der gespeicherten Zahlungsmethode.
Kartenmarke der gespeicherten Karte.
Die letzten vier Ziffern der gespeicherten Karte.
Ablaufmonat der Karte.
Ablaufjahr der Karte.
Gibt an, ob diese Zahlungsmethode nun die Standardmethode ist.
Zahlungsmethode entfernen
Entfernen Sie eine gespeicherte Zahlungsmethode anhand ihrer internen UUID.
Pfadparameter
Interne UUID der zu entfernenden Zahlungsmethode.
Antwortfelder
Gibt an, ob die Zahlungsmethode erfolgreich entfernt wurde.
Statusmeldung der API. Bei Erfolg ist der Wert Payment method deleted.
Standard-Zahlungsmethode festlegen
Setzen Sie eine vorhandene gespeicherte Zahlungsmethode als Standard für künftige Abrechnungen und Guthabenkäufe.
Pfadparameter
Interne UUID der Zahlungsmethode, die als Standard gesetzt werden soll.
Antwortfelder
Gibt an, ob die Standard-Zahlungsmethode erfolgreich aktualisiert wurde.
Statusmeldung der API. Bei Erfolg ist der Wert Default payment method updated.
Hinweise zur Verwendung
Verwenden Sie beim Hinzufügen einer Karte die Stripe-paymentMethodId und beim Aktualisieren oder Löschen die interne Talkturo-id. Diese beiden Werte sind nicht austauschbar.
Wenn Sie einen API-Schlüssel verwenden, kann der Workspace-Kontext aus dem Schlüssel selbst abgeleitet werden. Bei sessionbasierten Anfragen müssen Sie den Workspace-Kontext gegebenenfalls explizit übergeben.