Initiate PayTo Payment Request

Initiate a payment against an active payment agreement.

Error Codes

CodeStatusReasonWhat to do
PAM_SB_PAG_NOT_FOUND_ERROR404Payment agreement not foundVerify payment_agreement_id and merchant ownership.
PAS_AGREEMENT_STATUS_INACTIVE422Agreement is not activeActivate agreement before initiating payment.
PAS_AGREEMENT_ENDED400Agreement end date has passedUse a valid active agreement.
PAS_AGREEMENT_NOT_STARTED400Agreement start date is in futureRetry after agreement start date.
PAS_PAYMENT_TOO_SOON400Execution window/cooldown not metWait and retry after the cooldown window.
PAS_MAX_AMT_EXCEEDED400Amount exceeds agreement max amountLower amount or amend agreement limits.
R804422Duplicate/too-soon payment initiation detectedWait for cooldown window and retry once eligible.
R101422Amount exceeds per-transaction/agreement limitReduce amount to allowed limit.
R102422Daily spend limit exceededRetry next cycle or reduce amount.
R100422Daily transaction count limit exceededRetry next day or after account review.
R103422Destination payout not allowed for merchant settingsEnable eligible payout settings or remove destination.
R803422Upstream initiation failedRetry; if persistent, contact support with request metadata.
PAS_NPP_GATEWAY_ERROR502Provider gateway returned an errorRetry with backoff; contact support if repeated.
PAS_NPP_GATEWAY_TIMEOUT504Provider gateway timeoutRetry request and check status afterwards.
R805200Upstream timeout with accepted processing statePoll status using get endpoint until terminal state.
CREDITS_EXHAUSTED402Developer credits exhaustedTop up developer credits and retry.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
payment_initiation
object
required

Request payload used to initiate a payment against an active agreement.

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json