Create Account Updater job
Creates an Account Updater job.
A request is submitted to a third-party service, containing inquiries for a given set of payment methods. The job is not processed right away, but once created, it will store new card details automatically, if there are, when results are ready.
A payment method is considered for the job if the following conditions are met:
- It exists.
- It’s in a valid state:
statusis eithersucceededorprocessing. - It corresponds to a card:
methodiscard. - Its scheme is supported:
schemeisamex,discover,mastercardorvisa. - It doesn’t have an in-progress inquiry already.
The endpoint works in a best-efforts basis and it doesn’t return any error when a payment
method doesn’t qualify for an inquiry. To determine what payment methods were considered
for the job, an inquiries field, returned in the response body, contains the submitted
inquiries. If none of the payment methods qualified for an inquiry, the job is not created
and a 204 No Content status code is returned.
This endpoint requires the payment-methods.write scope.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
A request to create an Account Updater job.
A list of unique payment method identifiers used to create the Account Updater job. A payment method will be considered only if it qualifies for an inquiry.
Response
An Account Updater job.
The type of this resource. Is always account-updater-job.
account-updater-job The unique identifier for this Account Updater job.
The unique ID for a merchant account.
The date and time when this Account Updater job was created.
The date and time when this Account Updater job was last updated.
A list of inquiries associated with this Account Updater job.
Was this page helpful?