The time at which this data payload was valid. When sending events in realtime, this will usually be 'now'. This is used to merge data that arrives out-of-order.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The payout describing the earnings that a merchant is intended to pay to the supplier on their platform.
|
A unique identifier for this payout.
|
The stage of payout. This is used in reporting.
Please provide one of the following:
CREATED: The payout is yet to be submitted for processing, and is yet to be decide whether or not to send the payment.PENDING: The payout is submitted for processing, and is yet to receive status updates from the payment provider.PROCESSING: The payout request is received and currently being processed.CANCELLED: The payout has been cancelled by the sender.FAILED: Something went wrong, and the payout can no longer be fulfilled.COMPLETED: The payout has been completed and funds have been transferred successfully.BLOCKED: The payout has been blocked. For example, there are concerns with the payout or a potential issue with the recipient’s account.
|
An object of the payout amount breakdown. Each field should be a positive integer in the currency's basic units, representing how much to payout.
|
The total amount of money that a merchant wants to pay to their suppliers after deducting all fees, taxes, and other deductions. It represents the final amount that the supplier will receive after all the deductions have been made.
|
Currency of the payout amount, as an ISO 4217 currency code.
Pattern: ^[a-zA-Z]{3}$
|
The total amount of money that the merchant initially wants to pay to their suppliers, before any deductions have been made.
|
The sum of the fixed/defined earnings that forms the base income of the supplier. This excludes additional earnings such as purchases/goods/services/streams.
|
The sum of any approved compensations made to the supplier.
|
The sum of bonus campaigns or tips earned throughout the payout period stated.
|
The amount of income tax withheld from the supplier's payout.
|
The total revenue sourced from various revenue streams (e.g. trips, listeners, views) during the payout period stated.
|
The sum of commission fees and any deductions (except the withheld income tax) made from the total gross amount.
|
|
This object contains a breakdown of a supplier's revenue from sales represented as integers, with each value corresponding to a specific revenue source. It allows Ravelin to retrieve the distribution of revenue for a given supplier, enabling us to gain insight into the different revenue streams.
|
The revenue amount generated from advertising. This can include any ads-driven purchases/royalties/earnings on the platform.
|
The revenue amount generated from referrals. This can include any purchases made through a referral link to the product/platform.
|
The revenue amount generated from purchases/payments/consumptions associated with a promo/campaign/coupon.
|
The revenue amount generated from consumers who paid for the supplier’s product via a subscription plan. This source consists of recurring billings from subscribers.
|
The revenue amount generated by one-time payments done to the supplier. This can include any purchases made in the platform by ordering a new item, paying for a trip, one-time donations to the artist/supplier/content creator.
|
The revenue amount generated by any other revenue sources not covered by the above fields.
|
|
The start time of the date range of earnings that is covered by this payout.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The end time of the date range of earnings that is covered by this payout.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time that the payout object is created by the merchant. If this
value is unknown, you can set it to the time the request is sent.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time that the payout is submitted to the payment processor.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The schedule on which the payout was created.
One of the following:
MONTHLY: The payout was created as a result of a monthly process.WEEKLY: The payout was created as a result of a weekly process.DAILY: The payout was created as a result of a daily process.ON_DEMAND: The payout was not created on a schedule, it was initiated on-demand.
|
The actor who initiated the payout.
One of the following:
AGENT: A customer support agent initiated the payout.SUPPLIER: The supplier initiated the payout.AUTOMATED: The payout was initiated via an automated process.
|
Payout updates to be delivered to this email address (this info can be valuable if the email registered to receive payout notifications is different to the supplier.email field).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
The supplier that is set as the recipient of this payout.
|
The unique identifier of the supplier.
|
The role of the supplier in order fulfilment.
One of:
driver - A taxi driver, private hire driver, chauffeur or other type of person that drives people in a passenger motor vehicle.courier - A courier, bike courier or delivery driver.restaurant - A restaurant or cafe that sells prepared food. May also provide delivery.shop - A shop which sells goods other than prepared food. May also provide delivery.seller - An individual who sells goods or services and which is not covered by any of the other supplier types.contentCreator - A supplier that is creating content, for example, music, podcasts or video. The type of content creator should be set in the category field.promoter - A supplier that promotes music concerts, festivals, sporting events or other events or experiences, or a supplier that promotes products or services, for example an affiliate partner.other - Any other type of supplier which is not covered by the other types.
|
The unique identifier of the supplier's parent organisation.
|
The name of the supplier's parent organisation.
|
The time that the supplier registered. If this value is unknown, you
can set it to the time the request is sent.
Ravelin will retain the earliest value you have sent for this supplier ID.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The email address of the supplier.
|
The time at which the supplier verified their email, usually by
following a link back to your website from an email you sent to
their address.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The full name of the supplier.
|
The telephone number of the supplier. Best in
E.164 format with an
international dialing code.
|
The time at which the supplier verified their telephone number,
usually by confirming a code from an SMS you sent to the number.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The country the telephone number directs to. Note that the country is
not an adequate replacement for the international dialing code in the
Dominican Republic or Puerto Rico where multiple dialing codes are
used.
A ISO 3166-1 Alpha 3
or Alpha 2 country code.
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
Store tax address information at the time of payout to compare it to suppliers’ other addresses. Tax info maps to each payout object and is immutable. This could be different in any subsequent payouts.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The logical region in which this supplier exists.
Pattern: ^[0-9a-z-]*$
|
The logical country for this supplier. Doesn't change when the supplier is briefly abroad.
|
The logical city in which this supplier exists.
Pattern: ^[0-9a-z-]*$
|
The name of the current level of the supplier.
|
This describes how the supplier is employed by your organisation, e.g. "selfEmployed", or "partTime".
|
The type of transport this supplier uses.
|
The highest level category that applies to this supplier.
|
The type of supplier account.
One of:
INDIVIDUAL - To be used when the supplier account is an individual account, for example an individual person selling goods or an individual person creating content under their own name.BUSINESS - To be used when the supplier account is a business account, for example when there is a business or organisation or company associated to the supplier account, a shop selling goods, a restaurant selling food, or a business creating content.
|
The platform where the supplier account was created.
|
This field would be used to indicate the status of the supplier's identity verification process, which is usually conducted to ensure compliance with anti-money laundering and other regulations.
|
The tags to set or unset. Use the tag ID followed by true or false, depending on whether you want to set or unset the tag.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
An eventType should identify what event in your system triggered this API call.
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_]*$
|
A primary payout method for funds to be transferred in by the merchant.
|
|
Card - A credit or debit card.
Show definition
|
Card payment method indicator.
One of:
card - Card payment method indicator. Used for both credit and debit cards.creditcard - Deprecated. Use card.debitcard - Deprecated. Use card.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The card network or scheme, such as visa or mastercard. Ravelin will identify the scheme on your behalf if you send the cardBin, which should be preferred.
|
A unique identifier for the physical card, shared between customers. Used
to link cards in Connect. Must not be a hash of the PAN.
If you use multiple PSPs who each generate their own equivalent of an
instrumentId, you should consider prefixing their values to indicate
their origin to avoid collisions. Common examples include Stripe's
fingerprint,
or Braintree's
unique_number_identifier).
|
The full Primary Account Number of the card.
This should be 14-19 digits. For example 1234123412341234. This should not contain hyphens or spaces.
Used by Ravelin to generate the instrumentId for this card.
If specified, you do not need to provide instrumentId, cardBin or cardLastFour.
Only PCI DSS SAQ-D certified merchants should submit the PAN to Ravelin. You must not send requests
containing this field to api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The Payment Account Reference (PAR) is a unique, consistent, non-sensitive
identifier for the current Primary Account Number (PAN) for the customer's
payment account. However, unlike the PAN, which can change if a card is lost
or stolen, the PAR can be remapped to identify a new PAN, and so remains the
same for the lifetime of the payment account.
The PAR is issued by card schemes and is defined by the EMV® Payment Account
Reference (PAR) White Paper (PDF download).
It is an ideal value to use as the instrumentId.
If you have the PAR when requesting a recommendation, and you've not already
provided an instrumentId in a previous request, use the PAR as the
instrumentId, and do not use this paymentAccountReference field.
If you do not have the PAR when requesting a recommendation, or you've already
provided an instrumentId in a previous request, populate this paymentAccountReference
field when the PAR is available.
Required length: 29 characters.
|
The first six or eight digits of the card number/PAN. The Bank Identification
Number (BIN), recently more commonly known as the Issuer
Identification Number (IIN).
Given the BIN, Ravelin will populate the issuer, country of issuance,
and card type on your behalf.
|
The last four digits of the card number/PAN. Please note this will be truncated to the last two digits when an eight digit BIN is provided.
|
The card issuer, who the true cardholder will report fraud to. Ravelin
will identify the issuer on your behalf if you send the cardBin,
which should be preferred.
|
Whether this is a prepaid debit card. Ravelin will identify whether
the card is prepaid on your behalf if you send the cardBin which
should be preferred.
|
The country that the card was issued in. Ravelin will identify the
country of issuance on your behalf if you send the cardBin, which
should be preferred.
A ISO 3166-1 Alpha 3
or Alpha 2 country
code.
|
The expiry month of the card.
|
The expiry year of the card.
|
|
|
The address of the registered cardholder, as used to pass
AVS
checks. It is common to have fewer location details for this address,
but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
Whether this payment method is a corporate card.
|
Whether this payment method is a virtual card.
|
Whether the card was successfully registered with your gateway/PSP.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Whether the card has been compromised.
|
The reason why the card is considered compromised.
One of:
cloned, databreach, found, lost, stolen, frozen, defrosted, or uncompromised.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
active
boolean
optional
deprecated
Whether this card is still saved to the customer's account.
|
banned
boolean
optional
deprecated
Whether this card has been banned.
|
The e-Wallet to which the customer associated the card.
One of:
applepay, googlepay, samsungpay, amazonpay, or visacheckout.
|
The nickname the customer has given the payment method.
|
The card network or scheme, such as visa or mastercard. Ravelin
will identify the cardType on your behalf if you send the cardBin,
which should be preferred.
|
|
|
Payment Method Cipher - An encrypted payment method, containing the full card details encrypted via a
Ravelin SDK.
Show definition
|
Client-side encrypted card payment method indicator.
Only:
paymentMethodCipher.
|
The card ciphertext produced by the Ravelin SDK card encryption.
This field constitutes cardholder data, and submission of this field therefore requires PCI DSS
SAQ-A or SAQ-AEP certification. You must not send requests containing this field to
api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The AES Key ciphertext produced by the Ravelin SDK card encryption.
|
The algorithm used to generate the ciphertexts.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The version of the Ravelin SDK that performed this encryption.
|
The index of the public RSA key used to encrypt the card.
|
An identifier for the public key used during encryption.
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
When the payment method was added to the customer's account. Note: this is not the card start date.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The version of the ravelinjs library that performed this encryption.
|
|
|
Cash - The customer is paying in cash, or a cash-based payment method.
Show definition
|
Indicator of a cash payment, or cash-based payment method (e.g. paysafecard).
Only:
cash.
|
The name of the cash-based payment service used, if applicable.
|
|
|
Bank Account - Bank Accounts.
Show definition
|
Bank account payment method indicator.
Only:
bankaccount.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The type of transfer: whether the customer is initiating the payment, or you are withdrawing funds from the customer's bank account based on an agreement to initiate payments on their behalf. Use "push" for a customer-initiated payment (e.g. a bank transfer) and "pull" for a merchant-initiated payment (e.g. Direct Debit).
One of:
push, or pull.
|
The name of the payment scheme or instrument used for the transfer of funds.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The type of the account.
One of the following:
SAVINGS: A savings account, which is designed to help customers save money and earn interest.CURRENT: A checking account, which is designed for frequent transactions and typically has low or no interest rates.
|
The name of the account owner.
|
The type of customer or entity that the account is associated with, whether it's an individual or a business.
One of the following:
PERSONAL: A bank account owned and used by an individual for personal transactions. Can include joint accounts.BUSINESS: A bank account owned by a company or organisation for business transactions.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The nickname for the payment method that the customers gives, if applicable.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
PayPal - PayPal payments.
Show definition
|
PayPal payment method indicator.
Only:
paypal.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
|
|
|
|
The address of the account holder. It is common to have fewer location
details for this address, but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The nickname for the payment method that the customer gives, if applicable.
|
|
|
|
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
banned
boolean
optional
deprecated
If the payment method has been banned
|
active
boolean
optional
deprecated
Whether the payment method is active for use by this account
|
|
|
Credit - This payment method type should be used for any payments made using credit that a customer has with the merchant.
Show definition
|
Credit payment method indicator.
Only:
credit.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the store credit scheme used as a payment method, if applicable.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Invoice - This payment method should be used whenever the merchant provides credit to the customer.
Show definition
|
Invoice payment method indicator.
Only:
invoice.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the invoice or 'buy now, pay later' scheme used, if applicable.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The nickname for the payment method that the customers gives, if applicable.
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The email address used by the customer to register an invoice or 'buy now, pay later' payment method.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Wallet - A digital wallet payment method.
Show definition
|
Wallet payment method indicator.
Only:
wallet.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the digital wallet scheme or electronic payment service.
For common wallets, please send the official name only, for example
applepay or googlepay.
|
The card network or scheme of the card used within a wallet payment method,
such as visa or mastercard. Ravelin will identify the cardScheme on your behalf
if you send the cardBin, which should be preferred.
|
A unique identifier for the physical card, shared between customers. Used
to link cards in Connect. Must not be a hash of the PAN or DPAN.
If you use multiple PSPs who each generate their own equivalent of an
instrumentId, you should consider prefixing their values to indicate
their origin to avoid collisions. Common examples include Stripe's
fingerprint,
or Braintree's
unique_number_identifier).
|
The full Primary Account Number of the card.
This should be 14-19 digits. For example 1234123412341234. This should not contain hyphens or spaces.
Used by Ravelin to generate the instrumentId for this card.
If specified, you do not need to provide instrumentId, cardBin or cardLastFour.
Only PCI DSS SAQ-D certified merchants should submit the PAN to Ravelin. You must not send requests
containing this field to api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The Payment Account Reference (PAR) is a unique, consistent, non-sensitive
identifier for the current Primary Account Number (PAN) for the customer's
payment account. However, unlike the PAN, which can change if a card is lost
or stolen, the PAR can be remapped to identify a new PAN, and so remains the
same for the lifetime of the payment account.
The PAR is issued by card schemes and is defined by the EMV® Payment Account
Reference (PAR) White Paper (PDF download).
It is an ideal value to use as the instrumentId.
If you have the PAR when requesting a recommendation, and you've not already
provided an instrumentId in a previous request, use the PAR as the
instrumentId, and do not use this paymentAccountReference field.
If you do not have the PAR when requesting a recommendation, or you've already
provided an instrumentId in a previous request, populate this paymentAccountReference
field when the PAR is available.
Required length: 29 characters.
|
The first six or eight digits of the card number/PAN or DPAN. The Bank Identification
Number (BIN), recently also known as the Issuer
Identification Number (IIN).
If you have access to the card data within the wallet, then given the
cardBIN Ravelin will populate the issuer, countryIssued, and
cardType on your behalf.
|
The last four digits of the card number/PAN or DPAN.
|
The card network or scheme, such as visa or mastercard. Should
only be sent if you have access to the card data within the wallet,
rather than just the DPAN. Ravelin will identify the cardType on
your behalf if you send the cardBin, which should be preferred.
|
The card issuer, who the true cardholder will report fraud to. Should
only be sent if you have access to the card data within the wallet,
rather than just the DPAN. Ravelin will identify the issuer on your
behalf if you send the cardBin, which should be preferred.
|
Whether this is a prepaid debit card. Should only be sent if you have
access to the card data within the wallet, rather than just the DPAN.
Ravelin will identify the prepaidCard status on your behalf if you
send the cardBin, which should be preferred.
|
The country that the card was issued in. Should only be sent if you
have access to the card data within the wallet, rather than just the
DPAN. Ravelin will identify the countryIssued on your behalf if you
send the cardBin, which should be preferred.
A ISO 3166-1 Alpha 3
or Alpha 2 country code.
|
The expiry month of the card.
|
The expiry year of the card.
|
|
|
The address of the registered cardholder, as used to pass
AVS
checks. It is common to have fewer location details for this address,
but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
Whether the card was successfully registered with your gateway/PSP.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Google Pay specific field, which is available in the
AssuranceDetailsSpecifications
object from the Google Pay API. If true, indicates that cardholder possession has been validated.
We strongly recommend that you send this data for Google Pay transactions if you have access to this field.
|
A Google Pay specific field, which is available in the
AssuranceDetailsSpecifications
object from the Google Pay API. If true, indicates that identification and verification was performed.
We strongly recommend that you send this data for Google Pay transactions if you have access to this field.
|
The email address associated with the account where the wallet is set up. For example, this would be an @gmail.com email address for Google Pay wallets, or the email address associated with the Apple ID for Apple Pay wallets. In some cases a temporary email address may be used, for example, for Apple Pay this may be an @privaterelay.appleid.com email address.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
active
boolean
optional
deprecated
Whether this card is still saved to the customer's account.
|
banned
boolean
optional
deprecated
Whether this card has been banned.
|
The nickname the customer has given the payment method.
|
|
|
From Transaction - Refer to the payment method used by a named transaction.
For usage examples, see
Saving payment methods after checkout
and Associating refunds with payment methods.
Show definition
|
Indicator for using a payment method from another transaction.
Only:
fromTransaction.
|
The transaction ID to look up the payment method from.
|
The gateway that the transaction was processed through.
|
The gateway ref provided by the gateway for the transaction.
|
|
|
|
|
Direct Debit - Direct Debits. - deprecated.
Show definition
|
Direct Debit payment method indicator.
Only:
directdebit.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
|
|
The type of direct debit scheme.
One of:
autogiro, bacs, becs, becsnz, betalingsservice, or sepa.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The name of the account owner.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The unique reference issued for the direct debit mandate.
|
A URL to access the direct debit mandate agreement.
|
The nickname for the payment method that the customers gives, if applicable.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Bank Transfer - Bank Transfers. - deprecated.
Show definition
|
Bank transfer payment method indicator.
Only:
banktransfer.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
One of:
bancontact, eps, giropay, ideal, inghomepay, sofort, or sepa.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The name of the account owner.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The nickname for the payment method that the customers gives, if applicable.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Other - Other supported payment methods. - deprecated.
Show definition
|
Other payment method type indicator.
One of:
voucher, bitcoin, transfer, paysafe, cheque, or edenred.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The nickname for the payment method that the customers gives, if applicable.
|
banned
boolean
optional
deprecated
If the payment method has been banned
|
active
boolean
optional
deprecated
Whether the payment method is active for use by this account
|
|
|
Removal: Used for marking a saved payment method as removed from the account.
Show definition
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
False to indicate the payment method has been deactivated.
Only:
false.
|
|
A primary payout method for funds to be transferred in by the merchant.
|
|
Card - A credit or debit card.
Show definition
|
Card payment method indicator.
One of:
card - Card payment method indicator. Used for both credit and debit cards.creditcard - Deprecated. Use card.debitcard - Deprecated. Use card.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The card network or scheme, such as visa or mastercard. Ravelin will identify the scheme on your behalf if you send the cardBin, which should be preferred.
|
A unique identifier for the physical card, shared between customers. Used
to link cards in Connect. Must not be a hash of the PAN.
If you use multiple PSPs who each generate their own equivalent of an
instrumentId, you should consider prefixing their values to indicate
their origin to avoid collisions. Common examples include Stripe's
fingerprint,
or Braintree's
unique_number_identifier).
|
The full Primary Account Number of the card.
This should be 14-19 digits. For example 1234123412341234. This should not contain hyphens or spaces.
Used by Ravelin to generate the instrumentId for this card.
If specified, you do not need to provide instrumentId, cardBin or cardLastFour.
Only PCI DSS SAQ-D certified merchants should submit the PAN to Ravelin. You must not send requests
containing this field to api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The Payment Account Reference (PAR) is a unique, consistent, non-sensitive
identifier for the current Primary Account Number (PAN) for the customer's
payment account. However, unlike the PAN, which can change if a card is lost
or stolen, the PAR can be remapped to identify a new PAN, and so remains the
same for the lifetime of the payment account.
The PAR is issued by card schemes and is defined by the EMV® Payment Account
Reference (PAR) White Paper (PDF download).
It is an ideal value to use as the instrumentId.
If you have the PAR when requesting a recommendation, and you've not already
provided an instrumentId in a previous request, use the PAR as the
instrumentId, and do not use this paymentAccountReference field.
If you do not have the PAR when requesting a recommendation, or you've already
provided an instrumentId in a previous request, populate this paymentAccountReference
field when the PAR is available.
Required length: 29 characters.
|
The first six or eight digits of the card number/PAN. The Bank Identification
Number (BIN), recently more commonly known as the Issuer
Identification Number (IIN).
Given the BIN, Ravelin will populate the issuer, country of issuance,
and card type on your behalf.
|
The last four digits of the card number/PAN. Please note this will be truncated to the last two digits when an eight digit BIN is provided.
|
The card issuer, who the true cardholder will report fraud to. Ravelin
will identify the issuer on your behalf if you send the cardBin,
which should be preferred.
|
Whether this is a prepaid debit card. Ravelin will identify whether
the card is prepaid on your behalf if you send the cardBin which
should be preferred.
|
The country that the card was issued in. Ravelin will identify the
country of issuance on your behalf if you send the cardBin, which
should be preferred.
A ISO 3166-1 Alpha 3
or Alpha 2 country
code.
|
The expiry month of the card.
|
The expiry year of the card.
|
|
|
The address of the registered cardholder, as used to pass
AVS
checks. It is common to have fewer location details for this address,
but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
Whether this payment method is a corporate card.
|
Whether this payment method is a virtual card.
|
Whether the card was successfully registered with your gateway/PSP.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Whether the card has been compromised.
|
The reason why the card is considered compromised.
One of:
cloned, databreach, found, lost, stolen, frozen, defrosted, or uncompromised.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
active
boolean
optional
deprecated
Whether this card is still saved to the customer's account.
|
banned
boolean
optional
deprecated
Whether this card has been banned.
|
The e-Wallet to which the customer associated the card.
One of:
applepay, googlepay, samsungpay, amazonpay, or visacheckout.
|
The nickname the customer has given the payment method.
|
The card network or scheme, such as visa or mastercard. Ravelin
will identify the cardType on your behalf if you send the cardBin,
which should be preferred.
|
|
|
Payment Method Cipher - An encrypted payment method, containing the full card details encrypted via a
Ravelin SDK.
Show definition
|
Client-side encrypted card payment method indicator.
Only:
paymentMethodCipher.
|
The card ciphertext produced by the Ravelin SDK card encryption.
This field constitutes cardholder data, and submission of this field therefore requires PCI DSS
SAQ-A or SAQ-AEP certification. You must not send requests containing this field to
api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The AES Key ciphertext produced by the Ravelin SDK card encryption.
|
The algorithm used to generate the ciphertexts.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The version of the Ravelin SDK that performed this encryption.
|
The index of the public RSA key used to encrypt the card.
|
An identifier for the public key used during encryption.
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
When the payment method was added to the customer's account. Note: this is not the card start date.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The version of the ravelinjs library that performed this encryption.
|
|
|
Cash - The customer is paying in cash, or a cash-based payment method.
Show definition
|
Indicator of a cash payment, or cash-based payment method (e.g. paysafecard).
Only:
cash.
|
The name of the cash-based payment service used, if applicable.
|
|
|
Bank Account - Bank Accounts.
Show definition
|
Bank account payment method indicator.
Only:
bankaccount.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The type of transfer: whether the customer is initiating the payment, or you are withdrawing funds from the customer's bank account based on an agreement to initiate payments on their behalf. Use "push" for a customer-initiated payment (e.g. a bank transfer) and "pull" for a merchant-initiated payment (e.g. Direct Debit).
One of:
push, or pull.
|
The name of the payment scheme or instrument used for the transfer of funds.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The type of the account.
One of the following:
SAVINGS: A savings account, which is designed to help customers save money and earn interest.CURRENT: A checking account, which is designed for frequent transactions and typically has low or no interest rates.
|
The name of the account owner.
|
The type of customer or entity that the account is associated with, whether it's an individual or a business.
One of the following:
PERSONAL: A bank account owned and used by an individual for personal transactions. Can include joint accounts.BUSINESS: A bank account owned by a company or organisation for business transactions.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The nickname for the payment method that the customers gives, if applicable.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
PayPal - PayPal payments.
Show definition
|
PayPal payment method indicator.
Only:
paypal.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
|
|
|
|
The address of the account holder. It is common to have fewer location
details for this address, but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The nickname for the payment method that the customer gives, if applicable.
|
|
|
|
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
banned
boolean
optional
deprecated
If the payment method has been banned
|
active
boolean
optional
deprecated
Whether the payment method is active for use by this account
|
|
|
Credit - This payment method type should be used for any payments made using credit that a customer has with the merchant.
Show definition
|
Credit payment method indicator.
Only:
credit.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the store credit scheme used as a payment method, if applicable.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Invoice - This payment method should be used whenever the merchant provides credit to the customer.
Show definition
|
Invoice payment method indicator.
Only:
invoice.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the invoice or 'buy now, pay later' scheme used, if applicable.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The nickname for the payment method that the customers gives, if applicable.
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The email address used by the customer to register an invoice or 'buy now, pay later' payment method.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Wallet - A digital wallet payment method.
Show definition
|
Wallet payment method indicator.
Only:
wallet.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
The name of the digital wallet scheme or electronic payment service.
For common wallets, please send the official name only, for example
applepay or googlepay.
|
The card network or scheme of the card used within a wallet payment method,
such as visa or mastercard. Ravelin will identify the cardScheme on your behalf
if you send the cardBin, which should be preferred.
|
A unique identifier for the physical card, shared between customers. Used
to link cards in Connect. Must not be a hash of the PAN or DPAN.
If you use multiple PSPs who each generate their own equivalent of an
instrumentId, you should consider prefixing their values to indicate
their origin to avoid collisions. Common examples include Stripe's
fingerprint,
or Braintree's
unique_number_identifier).
|
The full Primary Account Number of the card.
This should be 14-19 digits. For example 1234123412341234. This should not contain hyphens or spaces.
Used by Ravelin to generate the instrumentId for this card.
If specified, you do not need to provide instrumentId, cardBin or cardLastFour.
Only PCI DSS SAQ-D certified merchants should submit the PAN to Ravelin. You must not send requests
containing this field to api.ravelin.com, and must instead use pci.ravelin.com.
Please see our PCI DSS documentation for more information.
|
The Payment Account Reference (PAR) is a unique, consistent, non-sensitive
identifier for the current Primary Account Number (PAN) for the customer's
payment account. However, unlike the PAN, which can change if a card is lost
or stolen, the PAR can be remapped to identify a new PAN, and so remains the
same for the lifetime of the payment account.
The PAR is issued by card schemes and is defined by the EMV® Payment Account
Reference (PAR) White Paper (PDF download).
It is an ideal value to use as the instrumentId.
If you have the PAR when requesting a recommendation, and you've not already
provided an instrumentId in a previous request, use the PAR as the
instrumentId, and do not use this paymentAccountReference field.
If you do not have the PAR when requesting a recommendation, or you've already
provided an instrumentId in a previous request, populate this paymentAccountReference
field when the PAR is available.
Required length: 29 characters.
|
The first six or eight digits of the card number/PAN or DPAN. The Bank Identification
Number (BIN), recently also known as the Issuer
Identification Number (IIN).
If you have access to the card data within the wallet, then given the
cardBIN Ravelin will populate the issuer, countryIssued, and
cardType on your behalf.
|
The last four digits of the card number/PAN or DPAN.
|
The card network or scheme, such as visa or mastercard. Should
only be sent if you have access to the card data within the wallet,
rather than just the DPAN. Ravelin will identify the cardType on
your behalf if you send the cardBin, which should be preferred.
|
The card issuer, who the true cardholder will report fraud to. Should
only be sent if you have access to the card data within the wallet,
rather than just the DPAN. Ravelin will identify the issuer on your
behalf if you send the cardBin, which should be preferred.
|
Whether this is a prepaid debit card. Should only be sent if you have
access to the card data within the wallet, rather than just the DPAN.
Ravelin will identify the prepaidCard status on your behalf if you
send the cardBin, which should be preferred.
|
The country that the card was issued in. Should only be sent if you
have access to the card data within the wallet, rather than just the
DPAN. Ravelin will identify the countryIssued on your behalf if you
send the cardBin, which should be preferred.
A ISO 3166-1 Alpha 3
or Alpha 2 country code.
|
The expiry month of the card.
|
The expiry year of the card.
|
|
|
The address of the registered cardholder, as used to pass
AVS
checks. It is common to have fewer location details for this address,
but provide what you have.
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
Whether the card was successfully registered with your gateway/PSP.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
The time at which the payment method was last verified by the customer.
An example mechanism would be a random amount charged to the
customer's card that they can confirm the amount of.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Google Pay specific field, which is available in the
AssuranceDetailsSpecifications
object from the Google Pay API. If true, indicates that cardholder possession has been validated.
We strongly recommend that you send this data for Google Pay transactions if you have access to this field.
|
A Google Pay specific field, which is available in the
AssuranceDetailsSpecifications
object from the Google Pay API. If true, indicates that identification and verification was performed.
We strongly recommend that you send this data for Google Pay transactions if you have access to this field.
|
The email address associated with the account where the wallet is set up. For example, this would be an @gmail.com email address for Google Pay wallets, or the email address associated with the Apple ID for Apple Pay wallets. In some cases a temporary email address may be used, for example, for Apple Pay this may be an @privaterelay.appleid.com email address.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
active
boolean
optional
deprecated
Whether this card is still saved to the customer's account.
|
banned
boolean
optional
deprecated
Whether this card has been banned.
|
The nickname the customer has given the payment method.
|
|
|
From Transaction - Refer to the payment method used by a named transaction.
For usage examples, see
Saving payment methods after checkout
and Associating refunds with payment methods.
Show definition
|
Indicator for using a payment method from another transaction.
Only:
fromTransaction.
|
The transaction ID to look up the payment method from.
|
The gateway that the transaction was processed through.
|
The gateway ref provided by the gateway for the transaction.
|
|
|
|
|
Direct Debit - Direct Debits. - deprecated.
Show definition
|
Direct Debit payment method indicator.
Only:
directdebit.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
|
|
The type of direct debit scheme.
One of:
autogiro, bacs, becs, becsnz, betalingsservice, or sepa.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The name of the account owner.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The unique reference issued for the direct debit mandate.
|
A URL to access the direct debit mandate agreement.
|
The nickname for the payment method that the customers gives, if applicable.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Bank Transfer - Bank Transfers. - deprecated.
Show definition
|
Bank transfer payment method indicator.
Only:
banktransfer.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
One of:
bancontact, eps, giropay, ideal, inghomepay, sofort, or sepa.
|
IBAN (International Bank Account Number)
Following the ISO 13616:2007 standard.
|
|
|
|
Show definition
|
|
|
The postal or zip code. If provided without latitude or longitude, Ravelin will perform coarse geolocation in some countries.
|
The latitude of the location.
|
The longitude of the location.
|
The name of the person that will accept delivery of goods to this address.
|
The street address of the location.
|
The street address of the location.
|
The neighbourhood of the location.
|
The zone of the location.
|
|
|
The state/county of the location.
|
The PO box number related to the location.
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The geohash of the location.
|
|
The name of the account owner.
|
Code assigned by central bank to identify bank that account is associated with.
Multiple bank code formats are supported.
|
Name of bank which account belongs to.
|
BIC - business identifier code for banks and other institutions.
Following the ISO9362 standard.
|
The account number issued by the bank.
|
The nickname for the payment method that the customers gives, if applicable.
|
The time that the card was saved to the customer's account. (Not the card start date.)
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
|
|
Other - Other supported payment methods. - deprecated.
Show definition
|
Other payment method type indicator.
One of:
voucher, bitcoin, transfer, paysafe, cheque, or edenred.
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
When the payment method was added to the customer's account.
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
A Unix timestamp preferably as an
integer count of milliseconds since 1970-01-01T00:00 UTC
(nanoseconds are also accepted).
|
Custom data that is relevant to your domain. This can be any json object.
Please include any details that you think are relevant to fraud that our
schema does not capture.
|
The nickname for the payment method that the customers gives, if applicable.
|
banned
boolean
optional
deprecated
If the payment method has been banned
|
active
boolean
optional
deprecated
Whether the payment method is active for use by this account
|
|
|
Removal: Used for marking a saved payment method as removed from the account.
Show definition
|
A unique identifier for this payment method, specific to this customer. Two
customers should not use the same paymentMethodId.
|
False to indicate the payment method has been deactivated.
Only:
false.
|
|