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
Query Parameters
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.
Path parameters
Query parameters
Ignored on create. Default is set only via POST …/set-default after verification_status is verified.
Request
Country associated with this card payment method (ISO 3166-1 alpha-2)
Response
Card payment method created as pending; verification continues asynchronously