Add card payment method
Adds a new card payment method for a payee. Supports push-to-card payments with card number and expiry details.
The payment method is created as pending and returns 201. Card verification continues asynchronously. Use GET payment methods or payment_method.verified / payment_method.failed webhooks to observe the terminal status. Create-time default is not applied — call set-default after verified.
Path Parameters
Request Body
Response Body
Success Responses
Error Responses
Authentication
RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox.
Short-lived session JWT from the Session Tokens API. Send as Authorization: Bearer <token>. Accepted on payment-method endpoints for a specific payee or payer; mint tokens with an API key.
Path parameters
Request
Country associated with this card payment method (ISO 3166-1 alpha-2)
Response
Card payment method created as pending; verification continues asynchronously