Payment Composition

Base composition fields shared between payment and payout operations.

operationType

enum<string>

required

Operation Type that was executed in the Provider.

Available options:

Authorize,

Preauthorize,

Capture,

Cancel,

Refund,

Credit,

SendNotification,

CaptureNotification,

RefundNotification,

CancelNotification,

AuthorizeNotification,

ChargebackNotification,

ChargebackReverseNotification,

IssuerCommentsNotification,

AcceptDispute,

DefendDispute,

SubmitEvidence,

PullDispute,

Get,

Search,

GetToken,

Tokenize,

DisableToken,

Register,

Generate3DS,

Validate3DS,

PayerAuthInit,

PayerAuthCheckEnroll,

PayerAuthValidate,

RefundFailedNotification,

RefundReversedNotification,

CaptureFailedNotification,

ValidateRedirect,

RefundNotificationUpdated

integrationType

enum<string>

required

Code of the integration type for using the payment method in the provider.

Available options:

api,

hpp,

inperson

amount

object

required

The amount used to execute the operation.

Hide child attributes

amount.value

string

required

Decimal amount of the major currency unit. Can be any precision.

Pattern: [0-9]+(\.[0-9]+)?

Example:

"12.50"

amount.currency

string

required

ISO 3-letter currency code.

Pattern: ^[A-Z]{3}$

Example:

"EUR"

success

boolean

required

Operation outcome. If true, then the operation was finished successfully, and false otherwise.

paymentMethodCode

enum<string>

Code of the payment method selected to perform the payment.

Available options:

alexBankMa7fazty,

amazonPay,

applePay,

audi2pay,

alfa,

alipay,

bankTransfer,

card,

2c2p,

capitecPay,

cibSmartWallet,

easypaisa,

etisalatCash,

fawryMobileWallet,

fawryPay,

googlePay,

jazzCash,

mercadoPago,

monoDirectDebit,

nbePhoneCash,

orangeCash,

oPayWallet,

pagaWallet,

payflex,

payjustnow,

payPal,

pix,

konnect,

qnbEWallet,

wafaCashWallet,

weCash,

genericRedirect,

eftPro,

upi,

upiDirect,

cashFreeWallet,

paytmMWallet,

netBanking,

meezaWallet,

vodafoneCash,

alipayQRCode,

sepaDirectDebit,

sepaDirectDebitDirect,

dcb,

bankAccount,

modo,

ach,

payzoneCash,

revolutPay,

lean,

tabby,

boleto,

oxxo,

spei,

promptPay,

qris,

momoVN,

vietQR,

konbini,

touchNGo,

gCash,

maya,

pse,

pagoEfectivo,

napas,

duitNowQR,

grabPay,

shopeePay,

nequi,

picPay,

ovo,

trueMoney,

iDeal,

iDealDirect,

bancontact,

mbWay,

mbWayDirect,

khipu,

razerGold,

webPay,

smartPix,

venmo,

klarnaPayLater,

klarnaPayNow,

klarnaPayOverTime,

knet,

scalapay,

bizum,

payNow,

atome,

fpx,

swish,

bcp,

kiosk,

sbp,

wero

paymentInstrumentId

string<uuid>

Unique identifier of the Payment Instrument that the customer selected for the Payment.

storeInstrument

boolean

Holder intention to store the payment instrument on payout.

operationResult

enum<string>

Result of the Operation according to Payrails mapping from the provider response.

Available options:

Success,

Accepted,

Pending,

HTTPRedirectRequired,

FormRedirectRequired,

Unknown,

UnexpectedProviderResponse,

ProviderUnknownError,

ProviderConnectionError,

Timeout,

ProviderTimeout,

GenericRejection,

FraudRisk,

DuplicateOperation,

OperationNotAllowed,

InstrumentNotAllowed,

InvalidInstrument,

InsufficientBalance,

BlockedInstrument,

ExpiredInstrument,

ValidationError,

ParamsError,

ProviderConfigError,

InvalidSignature,

InternalServerError,

PayerCanceled,

AuthenticationError,

AuthenticationRequired,

LimitExceeded,

PaymentMethodNotSupported,

AuthorizationRevoked

providerId

string<uuid>

Unique identifier of the provider used to execute the operation.

provider

object

Provider used to execute the operation.

Hide child attributes

provider.id

string<uuid>

required

Unique identifier of the provider.

provider.name

string

required

Name of the provider.

provider.displayName

string

required

Display name of the provider.

provider.type

enum<string>

required

Provider type.

Available options:

Fraud,

Payment,

Payout,

Vault,

NetworkOffers,

ThreeDS,

NetworkGateway,

NetworkToken,

Bin,

Data,

Dispute,

DisputeAlert,

Tax,

Billing

provider.configSchema

string

required

JSON schema of the provider configuration.

provider.createdAt

string<date-time>

required

Date of creation of the provider.

provider.status

enum<string>

Status of the provider.

Available options:

active,

inactive

provider.selfOnboarding

object

Self-onboarding capabilities available for this provider.

Hide child attributes

provider.selfOnboarding.enabled

boolean

Whether self-onboarding is enabled for this provider.

provider.selfOnboarding.supportedAuthModes

enum<string>[]

Authentication modes supported for self-onboarding.

Available options:

none,

oauth

provider.notificationURLTemplate

string

Template of the notification URL for provider configs of that provider. The template contains variables between curly braces that can be mapped to the fields of the provider configs (e.g. {id}, {accountName}) and substituted to generate the notification URL of that provider config.

provider.updatedAt

string<date-time>

Last update of the provider.

providerConfigId

string<uuid>

Unique identifier of the provider configuration used to execute the operation.

operationProviderReference

string

Reference of the operation in the provider's system.

errors

object[]

The reason why the operation was not successful, set if success = false.

Hide child attributes

errors.id

string<uuid>

required

Unique identifier of the error. Please use this value when reporting an issue to our team, so we can help you faster.

errors.code

string

required

Machine-friendly error code assigned to the error. Check the full list of possible values here.

errors.detail

string

required

Human-readable description about the error, its cause, and resolution.

errors.docUrl

string

Link to the specific documentation about this particular code.

errors.reason

object

Metadata providing more details about the reason of the error. The structure of this object varies according to the code.

accountFundingTransaction

boolean

Indicates whether the payment was an Account Funding Transaction. For example, loading a prepaid card, topping up a wallet, or funding a person-to-person (P2P) money transfer.

authorizationCode

string

The acquirer authorization code if the payment was authorized.

acquirerMID

string

Merchant Identifier (MID) on the acquirer that processed the payment.

acquirerAccountCode

string

Account Code on the acquirer that processed the payment.

acquirerCountryCode

string

Country Code on the acquirer that processed the payment.

avsResultCode

string

Address Verification Service (AVS) check result, normalized to the card-network single-letter convention. Set only when the provider reports the check, and carried on subsequent operations (capture, cancel, refund) of the same payment. More values may be added as more providers report this check.

Y: address and postal code both match.
A: address matches, postal code does not.
Z: postal code matches, address does not.
N: neither address nor postal code match.
U: the issuer could not perform the check.

cvvResultCode

string

Card security code (CVV/CVC) check result, normalized to the card-network single-letter convention. Set only when the provider reports the check, and carried on subsequent operations (capture, cancel, refund) of the same payment. More values may be added as more providers report this check.

M: security code matched.
N: security code did not match.
U: the issuer could not perform the check.
P: the check was expected but not processed.

acquirerReference

string

Acquirer Reference Number (ARN) assigned to the payment by the issuer.

providerReference

string

Unique identifier of the Payment in an external system, e.g. PSP.

retrievalReference

string

Retrieval Reference Number (RRN) assigned to the payment by the issuer.

paymentInstrument

object

Payment Instrument and tokens used to execute the authorize operation.

Hide child attributes

paymentInstrument.id

string<uuid>

required

Id of the instrument.

paymentInstrument.createdAt

string<date-time>

required

Date and time when the Instrument was created in Payrails.

paymentInstrument.updatedAt

string<date-time>

required

When the Instrument was last updated.

paymentInstrument.holderId

string<uuid>

required

Unique identifier of the Holder in Payrails.

paymentInstrument.paymentMethod

enum<string>

required

Represents the payment method type.

Available options:

alexBankMa7fazty,

applePay,

audi2pay,

bankAccount,

card,

2c2p,

vietQR,

cibSmartWallet,

easypaisa,

etisalatCash,

fawryMobileWallet,

fawryPay,

googlePay,

jazzCash,

nbePhoneCash,

orangeCash,

payPal,

qnbEWallet,

weCash,

genericRedirect,

alfa,

konnect,

eftPro,

netBanking,

upi,

upiDirect,

cashFreeWallet,

paytmWallet,

phonePe,

iDeal,

iDealDirect,

bancontact,

mbWay,

mbWayDirect,

sepaDirectDebit,

sepaDirectDebitDirect,

klarnaPayLater,

klarnaPayNow,

klarnaPayOverTime,

scalapay,

payNow,

atome,

fpx,

swish,

sbp,

wero

paymentInstrument.status

enum<string>

required

Status of the instrument.

Available options:

created,

deleted,

enabled,

disabled,

transient

paymentInstrument.displayName

string

Instrument name suitable for display.

paymentInstrument.description

string

Description of the instrument.

paymentInstrument.default

boolean | null

True if this instrument is set as default for the holder.

paymentInstrument.merchantReference

string

Merchant-provided reference for the instrument.

paymentInstrument.fingerprint

string

System-wide unique identifier of the Instrument. If two Holders have the same instrument stored, this value will be the same for both, but the instrument and token IDs will be different. Cannot be used for payments, should only be used for analytics and fraud prevention.

paymentInstrument.futureUsage

enum<string>

Represents the future usage to define the payment flows that the stored instrument will be used for.

Available options:

Subscription,

CardOnFile,

UnscheduledCardOnFile

paymentInstrument.networkTransactionReference

string

Identifier of the initial payment made with this instrument on the Networks, e.g. Mastercard Trace ID or Visa Transaction ID.

paymentInstrument.transactionLinkId

string

Mastercard Transaction Link Identifier (TLID) of the transaction series this instrument belongs to. Returned by the card network on the initial cardholder-initiated transaction and required on economically related merchant-initiated transactions, such as recurring payments and installments, when the series spans payment providers.

paymentInstrument.data

Card · object

Type-specific information about the instrument.

Hide child attributes

paymentInstrument.data.network

enum<string>

required

Network of the instrument.

Available options:

unspecified,

visa,

visadankort,

mastercard,

amex,

diners,

discover,

unionpay,

unionpayuzcard,

maestro,

maestrobancontact,

hipercard,

jcb,

jcblankapay,

argencard,

aura,

belkart,

bpfuelcard,

cabal,

carnet,

cirrus,

chjonesfuelcard,

uzcard,

codensa,

dankort,

dinacard,

duet,

ebt,

eftpos,

elo,

euroshellfuelcard,

gecapital,

bc,

hrgstore,

humo,

lankapay,

lukoilfuelcard,

bancontact,

meeza,

newday,

mir,

ourocard,

pagobancomat,

paypak,

paypal,

phhfuelcard,

prostir,

rupay,

sbercard,

sodexo,

starrewards,

cencosud,

naranja,

troy,

uatp,

ukfuelcard,

verve,

voyager,

vpay,

wex,

cmi,

atm,

bankcard,

localbrand,

loyalty,

privatelabel,

fuelcard,

redfuelcard,

redliquidfuelcard

paymentInstrument.data.bin

string

required

First 6-8 digits of the Card number. Also known as IIN (Issuer Identification Number).

Required string length: 6 - 8

Example:

"416598"

paymentInstrument.data.suffix

string

required

Last digits of the Card number.

Required string length: 4

paymentInstrument.data.preferredScheme

enum<string>

Network of the instrument.

Available options:

unspecified,

visa,

visadankort,

mastercard,

amex,

diners,

discover,

unionpay,

unionpayuzcard,

maestro,

maestrobancontact,

hipercard,

jcb,

jcblankapay,

argencard,

aura,

belkart,

bpfuelcard,

cabal,

carnet,

cirrus,

chjonesfuelcard,

uzcard,

codensa,

dankort,

dinacard,

duet,

ebt,

eftpos,

elo,

euroshellfuelcard,

gecapital,

bc,

hrgstore,

humo,

lankapay,

lukoilfuelcard,

bancontact,

meeza,

newday,

mir,

ourocard,

pagobancomat,

paypak,

paypal,

phhfuelcard,

prostir,

rupay,

sbercard,

sodexo,

starrewards,

cencosud,

naranja,

troy,

uatp,

ukfuelcard,

verve,

voyager,

vpay,

wex,

cmi,

atm,

bankcard,

localbrand,

loyalty,

privatelabel,

fuelcard,

redfuelcard,

redliquidfuelcard

paymentInstrument.data.binLookup

object

Information about an issuer by the given BIN (or IIN).

Hide child attributes

paymentInstrument.data.binLookup.bin

string

required

First 6-8 digits of the Card number. Also known as IIN (Issuer Identification Number).

Required string length: 6 - 8

Example:

"416598"

paymentInstrument.data.binLookup.network

enum<string>

Network of the instrument.

Available options:

unspecified,

visa,

visadankort,

mastercard,

amex,

diners,

discover,

unionpay,

unionpayuzcard,

maestro,

maestrobancontact,

hipercard,

jcb,

jcblankapay,

argencard,

aura,

belkart,

bpfuelcard,

cabal,

carnet,

cirrus,

chjonesfuelcard,

uzcard,

codensa,

dankort,

dinacard,

duet,

ebt,

eftpos,

elo,

euroshellfuelcard,

gecapital,

bc,

hrgstore,

humo,

lankapay,

lukoilfuelcard,

bancontact,

meeza,

newday,

mir,

ourocard,

pagobancomat,

paypak,

paypal,

phhfuelcard,

prostir,

rupay,

sbercard,

sodexo,

starrewards,

cencosud,

naranja,

troy,

uatp,

ukfuelcard,

verve,

voyager,

vpay,

wex,

cmi,

atm,

bankcard,

localbrand,

loyalty,

privatelabel,

fuelcard,

redfuelcard,

redliquidfuelcard

paymentInstrument.data.binLookup.localNetwork

enum<string>

Card local network that supports the card, e.g. CartesBancaires, Dankort, Mada, Bancontact.

Available options:

bancontact,

cartesbancaires,

dankort,

mada

paymentInstrument.data.binLookup.issuer

string

Name of the bank or institution that issued the card.

paymentInstrument.data.binLookup.issuerCountry

object

Country of the bank or institution that issued the card.

Hide child attributes

paymentInstrument.data.binLookup.issuerCountry.code

string

required

ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$

paymentInstrument.data.binLookup.issuerCountry.iso3

string

ISO 3-letter country code. Returned by Payrails, but not interpreted in requests.

Pattern: ^[A-Z]{3}$

paymentInstrument.data.binLookup.issuerCountry.name

string

The English name of the country. Returned by Payrails, but not interpreted in requests.

paymentInstrument.data.binLookup.segment

string

Segment of the card, e.g. gold, black, business.

paymentInstrument.data.binLookup.type

string

Type of the card, e.g. credit, debit, prepaid, gift.

paymentInstrument.data.binLookup.typeDetails

string

More information about the card type, e.g. personal, commercial.

paymentInstrument.data.binLookup.isNetworkToken

boolean

Indicates whether the card credential represents a network token rather than a primary account number (PAN).

paymentInstrument.data.binLookup.isFlexCard

boolean

Indicates whether the card is enrolled in a Flexible Credential or Flex Card program supported by the network - e.g. Visa Flexible Credential, Mastercard FlexCard.

paymentInstrument.data.billingAddress

object

Billing Address of the instrument.

Hide child attributes

paymentInstrument.data.billingAddress.street

string

The name of the street of a postal address.

paymentInstrument.data.billingAddress.doorNumber

string

The number on the door, building, or room.

paymentInstrument.data.billingAddress.complement

string

Additional addressing information, 2nd line of postal address.

paymentInstrument.data.billingAddress.area

string

The name of the suburb or area within a city.

paymentInstrument.data.billingAddress.city

string

The name of the city of a postal address.

paymentInstrument.data.billingAddress.postalCode

string

The postal code.

paymentInstrument.data.billingAddress.state

string

The name of the state a postal address is in.

paymentInstrument.data.billingAddress.country

object

The country where the address is in.

Hide child attributes

paymentInstrument.data.billingAddress.country.code

string

required

ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$

paymentInstrument.data.billingAddress.country.iso3

string

ISO 3-letter country code. Returned by Payrails, but not interpreted in requests.

Pattern: ^[A-Z]{3}$

paymentInstrument.data.billingAddress.country.name

string

The English name of the country. Returned by Payrails, but not interpreted in requests.

paymentInstrument.data.billingAddress.latitude

number<float>

Latitude of the address in the GPS coordinate system.

paymentInstrument.data.billingAddress.longitude

number<float>

Longitude of the address in the GPS coordinate system.

paymentInstrument.data.billingAddress.phone

object

The phone to contact in the address (can be different that the customer's).

Hide child attributes

paymentInstrument.data.billingAddress.phone.number

string

required

The local number of the phone, such that countryCode + number can be dialed.

Pattern: ^[0-9]+$

paymentInstrument.data.billingAddress.phone.countryCode

string

International prefix of the phone, if known separately.

Pattern: ^\+?[0-9]+$

paymentInstrument.data.billingAddress.alias

string

Name of the address, e.g. home, work.

paymentInstrument.data.billingAddress.name

string

Name of the person to whom the address belongs to.

paymentInstrument.data.billingAddress.lastName

string

Last name of the person to whom the address belongs to.

paymentInstrument.data.billingAddress.email

string

Email of the person to whom the address belongs to.

paymentInstrument.data.expiryMonth

string

Expiry month of the Card.

Required string length: 2

paymentInstrument.data.expiryYear

string

Expiry year of the Card.

Required string length: 4

paymentInstrument.data.holderName

string

Name of the owner of the Card.

paymentInstrument.data.taxId

string

Payer-provided tax identification number (e.g. CPF in Brazil) collected on the instrument.

paymentInstrument.tokens

object[]

Payment Instrument tokens used to execute the authorize operation.

Hide child attributes

paymentInstrument.tokens.reference

string

Unique identifier of the token in the provider's system.

paymentInstrument.tokens.type

enum<string>

Type of the token.

Available options:

network,

vault,

psp,

networkOffers,

networkGateway

paymentInstrument.tokens.meta

object

Any provider-specific data that was stored for context in the token.

providerResponseAdditionalFields

object

Any provider-specific response data requested by merchant on authorize.

operationResultProviderDetails

object

Specific details of the provider response that mapped to the specific Payrails result.

Hide child attributes

operationResultProviderDetails.message

string

Message from the provider response.

operationResultProviderDetails.additionalData

object

Additional data sent in the provider response.

Hide child attributes

operationResultProviderDetails.additionalData.{key}

string

providerConfig

object

Provider configuration details associated with this operation.

Hide child attributes

providerConfig.additionalData

object

Custom key-value data configured on the provider configuration. Do not store secrets, credentials, or personally identifiable information (PII).

Hide child attributes

providerConfig.additionalData.{key}

string

dispute

object

Dispute related to the Workflow execution.

Hide child attributes

dispute.id

string<uuid>

required

Unique identifier for a dispute entity.

dispute.providerReference

string

required

Unique identifier of the Dispute in an external system, e.g. PSP.

dispute.amount

object

required

The amount used to execute the operation.

Hide child attributes

dispute.amount.value

string

required

Decimal amount of the major currency unit. Can be any precision.

Pattern: [0-9]+(\.[0-9]+)?

Example:

"12.50"

dispute.amount.currency

string

required

ISO 3-letter currency code.

Pattern: ^[A-Z]{3}$

Example:

"EUR"

dispute.status

enum<string>

required

Status of a Dispute.

Available options:

FraudAlert,

RetrievalOpened,

RetrievalChallenged,

RetrievalExpired,

RetrievalClosed,

DisputeNotified,

DisputeOpened,

DisputeChallenged,

DisputeWon,

DisputeLost,

DisputeExpired,

DisputeAccepted,

DisputeCancelled,

ArbitrationOpened,

ArbitrationWon,

ArbitrationLost

dispute.reason

string

required

Reason description indicating why the dispute was raised.

dispute.network

enum<string>

required

Network of the instrument.

Available options:

unspecified,

visa,

visadankort,

mastercard,

amex,

diners,

discover,

unionpay,

unionpayuzcard,

maestro,

maestrobancontact,

hipercard,

jcb,

jcblankapay,

argencard,

aura,

belkart,

bpfuelcard,

cabal,

carnet,

cirrus,

chjonesfuelcard,

uzcard,

codensa,

dankort,

dinacard,

duet,

ebt,

eftpos,

elo,

euroshellfuelcard,

gecapital,

bc,

hrgstore,

humo,

lankapay,

lukoilfuelcard,

bancontact,

meeza,

newday,

mir,

ourocard,

pagobancomat,

paypak,

paypal,

phhfuelcard,

prostir,

rupay,

sbercard,

sodexo,

starrewards,

cencosud,

naranja,

troy,

uatp,

ukfuelcard,

verve,

voyager,

vpay,

wex,

cmi,

atm,

bankcard,

localbrand,

loyalty,

privatelabel,

fuelcard,

redfuelcard,

redliquidfuelcard

dispute.createdAt

string<date-time>

required

Exact date and time when the Dispute was created.

dispute.paymentId

string<uuid>

Unique identifier for the payment related to the dispute.

dispute.activityType

enum<string>

What happened in the dispute event that triggered this notification, as a normalized label. Use it to detect a change - an escalation to the chargeback stage, evidence becoming due, a defense outcome - without keeping your own copy of the dispute's previous state to compare against. The values come from the same vocabulary as the dispute activity timeline. Note the two surfaces can label the same event differently: this field always uses the detailed vocabulary, while the timeline returned by the activities endpoint uses a coarser one unless detailed activity types are enabled for your account. Treat this field as the authoritative label for a notification. This labels a single event rather than describing a difference between two. An update that changes nothing is still delivered and repeats the previous label, so deduplicate on the dispute identifier together with this value if repeated notifications matter to you. The field is absent when the event cannot be classified.

Available options:

ChargebackNotification,

ChargebackReverseNotification,

PreArbitrationNotification,

ArbitrationNotification,

EvidenceRequired,

EvidenceSubmitted,

DisputeUnderReview,

IssuerCommentsReceived,

RetrievalNotification,

FraudReportNotification,

RetrievalInformationRequired,

RetrievalEvidenceSubmitted,

RetrievalUnderReview,

RetrievalLost,

RetrievalResolved,

FraudReportReceived,

ChargebackRaised,

ChargebackEvidenceSubmittedPreDebit,

ChargebackEvidenceReady,

ChargebackNotDefendable,

ChargebackAccepted,

PreArbitrationOpened,

PreArbitrationUnderReview,

PreArbitrationWon,

PreArbitrationLost,

PreArbitrationSecondChargeback,

PreArbitrationAccepted,

ArbitrationOpened,

ArbitrationEvidenceSubmitted,

ArbitrationUnderReview,

ArbitrationWon,

ArbitrationLost,

ArbitrationAccepted,

AcceptDispute,

DefendDispute,

SubmitEvidence,

DisputeWon,

DisputeLost,

DisputeResolved

dispute.chargebackStatus

enum<string>

Status of the chargeback.

Available options:

Incoming,

Executed,

Reversed,

SecondChargeback,

IssuerReponseTimeframeExpired,

ArbitrationReversed

dispute.previous

object

The values this event replaced. Present with null members on the first event of a dispute, when there was nothing to replace. Omitted entirely for providers that keep no dispute of their own, where there is no previous state to report.

Hide child attributes

dispute.previous.stage

enum<string> | null

Stage of the dispute.

Available options:

Created,

FraudReport,

Retrieval,

Chargeback,

PreArbitration,

Arbitration,

Unknown

dispute.previous.defenseStatus

enum<string> | null

Status of the defense.

Available options:

NotDefendable,

Undefended,

ReadyToSubmit,

Submitted,

Failed,

UnderReview,

Won,

Lost,

Accepted,

Resolved,

Unknown

dispute.previous.chargebackStatus

enum<string> | null

Status of the chargeback.

Available options:

Incoming,

Executed,

Reversed,

SecondChargeback,

IssuerReponseTimeframeExpired,

ArbitrationReversed

dispute.tags

string[]

Names of the tags currently attached to the dispute. Omitted when the dispute has no tags.

dispute.reasonCode

string

Reason code indicating why the dispute was raised.

retries

object

Information about an action retry. Present if the action failed, and a retry is scheduled.

Hide child attributes

retries.startedAt

string<date-time>

Time when the retry is set up, but not performed yet. When it is scheduled to be perform can be checked in 'nextScheduledAt'.

retries.completedAttempts

integer

Number of retry attempts completed so far.

retries.nextScheduledAt

string<date-time>

Time when the next retry attempt will be performed.

retries.stopReason

string

Reason for stopping further retries.

retries.idempotencyKey

string<uuid>

Idempotency key used to retry in case of timeout.

captureMode

enum<string>

Capture mode used for the payment operation.

Available options:

Instant,

Manual,

Delayed

paymentId

string<uuid>

Unique identifier of the Payment affected during execution of the operation.

reason

enum<string>

Reason for invoking the operation or action. Omit it if there is no reason. CustomerDontNeed is deprecated, use CustomerDoesNotNeed instead. With Other, reasonDescription is required for refunds: at least 3 characters after trimming. On refunds, reasonDescription is at most 255 characters for any reason.

Available options:

BetterPrice,

CustomerDoesNotNeed,

CustomerDontNeed,

DamagedProduct,

Duplicate,

FraudulentProduct,

LateDelivery,

Other,

ProductMismatchDescription,

WrongProduct,

WrongProductSpecification

reasonDescription

string

Reason description specified when the operation was initiated.

Example:

"Customer's order expired."

Payrails API Reference

Get started

Workflow

Payment

Provider

Merchant

Vault

Analytics

Reporting

Reconciliation

Dispute