AML Integration Guide

Reduce settlement delays and enhance compliance for international payments with Razorpay’s AML solutions.


Razorpay offers an Anti-Money Laundering (AML) solution, such as Basic AML, designed to help businesses reduce settlement delays and minimize compliance-related transaction flags. Our risk prediction engine analyses historical transaction data and regulatory signals to accurately identify potential risks, reducing AML flags by up to 90% while maintaining compliance standards.

Advantages

  • Reduced AML Hits: Up to 90% reduction in flagged transactions with proper implementation.
  • Faster Settlements: Minimise manual reviews and accelerate fund availability.
  • Improved Conversion: Collect additional details only when necessary, reducing customer friction.
  • Regulatory Compliance: Automatically meet RBI requirements for high-value transactions.

Basic AML enables you to proactively provide additional customer information with every order, thereby reducing the likelihood that it will be flagged for AML review.

You need to pass a few additional parameters related to AML in the Orders API. There is no other change in the rest of the

.

Sample Code

POST
/orders

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X POST https://api.razorpay.com/v1/orders \
-H "Content-Type: application/json" \
-d '{
"amount": 10000,
"currency": "",
"receipt": "receipt#1",
"customer_id": "cust_OwZZseNBf9Uqsi",
"customer_details": {
"business_type": "individual",
"name": " Nur Aisyah",
"email": "nur.aisyah@example.com",
"contact": "+60123456789",
"individual": {
"date_of_birth": {
"day": 27,
"month": 11,
"year": 1993
},
"place_of_birth": "Bengaluru",
"tax_identity": [
{
"name": "PAN",
"value": "ABCDE1234F"
}
]
}
}
}'
{
"amount": 10000,
"amount_due": 10000,
"amount_paid": 0,
"attempts": 0,
"created_at": 1703569876,
"currency": "INR",
"entity": "order",
"id": "order_NGrgEcmYJsfUyl",
"notes": {
"key1": "value3",
"key2": "value2"
},
"offer_id": null,
"receipt": "receipt#1",
"status": "created"
}

Request Parameters

amount

mandatory

integer The amount for which the order was created, in currency subunits. For example, for an amount of RM 295.00, enter 29500. Payment can only be made for this amount against the Order.

currency

mandatory

string ISO code for the currency in which you want to accept the payment. The default length is 3 characters. For example, INR.

receipt

optional

string Receipt number that corresponds to this order, set for your internal reference. Can have a maximum length of 40 characters and has to be unique.

customer_id

mandatory

string Unique identifier of the customer. For example, cust_1Aa00000000004.

customer_details

mandatory

string This contains details about the customer details of the order.

business_type

optional

string Indicates whether the customer is an individual or business entity. Possible values:

  • company

  • individual

    Watch Out!

    For transactions exceeding ₹2,50,000:

    • Individual customers: PAN is mandatory.
    • Business customers: GSTIN is mandatory.

name

mandatory

string Customer's name.

  • Character length: Between 5 and 50 characters.
  • Allowed characters: Uppercase letters (A-Z), lowercase letters (a-z), and spaces (not at the beginning).
  • Not allowed characters: Numbers, special characters (For example, @, ", ,, ., and so on.), Unicode characters, emojis, and non-Latin scripts or regional languages.
  • Prohibited names: Names must be meaningful and contextually appropriate.
    • Avoid using repetitive patterns (For example, aaa, xyz, kkk kk).
    • Names like litri litri, Hfg Gh, or husi husi are not permitted.
    • Curse words or offensive names are not prohibited.
  • Example: Gaurav Kumar.

email

optional

string The customer's email address. A maximum length of 64 characters for the username. For example, in "

", "gaurav.kumar" must not exceed 64 characters.

contact

optional

string The customer's phone number. A maximum length of 15 characters including country code. For example, +919123456780.

individual

object Required when business_type is individual.

date_of_birth

object Customer's date of birth (individuals) or date of incorporation (businesses).

day

integer Day of birth/incorporation (1-31).

month

integer Month of birth/incorporation (1-12).

year

integer Year of birth/incorporation (4-digit format).

place_of_birth

string Place where the customer was born or place of incorporation for businesses.

tax_identity

array List of tax identifiers.

name

string Type of tax identifier.

value

string The identifier value matching the expected format.

Response Parameters

amount

integer The amount for which the order was created, in currency subunits. For example, for an amount of RM 295.00, enter 29500.

amount_due

integer The amount pending against the order.

amount_paid

integer The amount paid against the order.

attempts

integer The number of payment attempts, successful and failed, that have been made against this order.

created_at

integer Indicates the Unix timestamp when this order was created.

currency

string ISO code for the currency in which you want to accept the payment. The default length is 3 characters.

entity

string Name of the entity. Here, it is order.

id

string The unique identifier of the order.

notes

object Key-value pair used to store additional information about the entity. Holds 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

offer_id

string The unique identifier of the offer. For example, offer_JHD834hjbxzhd38d.

receipt

string Receipt number that corresponds to this order. Can have a maximum length of 40 characters and has to be unique.

status

string The status of the order. Possible values:

  • created: When you create an order, it is in the created state. It stays in this state till a payment is attempted on it.
  • attempted: An order changes to the attempted state following the first payment attempt and remains in this state until at least one payment is successfully processed and captured.
  • paid: After the successful capture of the payment, the order moves to the paid state. No further payment requests are permitted once the order moves to the paid state.
    The order stays in the paid state even if the payment associated with the order is refunded.

Error Response Parameters

Here is how AML works:

  1. Razorpay screens each transaction in real-time.
  2. Additional customer details are requested only for high-risk orders.
  3. Low-risk orders proceed without extra fields.

To enable Basic AML feature, contact your Key Account Manager or email us at import-mission@razorpay.com.

Payment Flow For Customers

When a transaction is flagged as high-risk, customers will see an additional screen on Razorpay Checkout:

  1. Customer proceeds to payment. If flagged, Submit PAN details screen appears.
  2. Enter PAN and Date of birth details.
    • Mobile
      Submit PAN details screen
    • Web
      Submit PAN details screen web
  3. Click Continue to proceed with payment.

Watch Out!

This screen appears only for transactions identified as high-risk, ensuring minimal friction for the majority of customers.

For further assistance, reach out to our

or email us at import-mission@razorpay.com.


Is this integration guide useful?