⚠️ Important Payment Instructions

When sending a PayPal payment via Zelling, please make sure to follow these rules to avoid cancellation:

1️⃣ Match the Currency

The payment must be sent in the same currency that you set when creating the payment.

Example: If the payment was created with currency: USD, the PayPal payment cannot be sent in EUR.

If the currency does not match, the payment will be automatically cancelled.

💱 Supported Currencies

USD, EUR, GBP, CAD, JPY, AED, MYR, IDR, THB, CHF, SGD, RUB, ZAR, TRY, LKR, RON, BGN, HUF, CZK, PHP, PLN, UGX, MXN, INR, HKD, CNY, BRL, DKK, TWD, AUD, NGN, SEK, NOK, UAH, VND

2️⃣ Include the Server Note

In the PayPal payment note, you must include the exact note value returned by the server in the payment creation response.

This ensures that Zelling can properly match the payment to your transaction.

⚡ Tip: Copy the note directly from the API response and paste it into the PayPal note field. Missing or incorrect notes will result in an unmatched payment.

3️⃣ Additional Information (if required)

If during webhook setup you entered any additional_information field (as described in [How to connect PayPal for Zelling payments?]),
you must also include the exact same value in the PayPal payment note.

This ensures Zelling can correctly match your PayPal transaction with the created payment.

curl --location --request POST 'https://api.zelling.io/v1/paypal/payments' \ --header 'Content-Type: application/json' \ --data-raw '{ "currency": "EUR", "amount": 150.75, "payout_email": "your-paypal@example.com", "webhook_url": "https://example.com/webhook", "additional_information": "string", "meta": { "orderId": "ORD-001", "customerId": "12345", "notes": "Urgent payment" } }'

{ "message": "Payment created successfully", "data": { "pid": "PAY-1234567890", "currency": "EUR", "amount": 150.75, "status": "NEW", "payoutEmail": "your-paypal@example.com", "additionalInformation": null, "note": "bubbleshoutsoftdrumtowerglory", "webhookUrl": "https://example.com/webhook", "hostedUrl": "https://pay-paypal.zelling.io/PAY-1234567890", "meta": { "orderId": "ORD-001", "customerId": "12345", "notes": "Urgent payment" } } }

Create Paypal Payment

⚠️ Important Payment Instructions

1️⃣ Match the Currency

💱 Supported Currencies

2️⃣ Include the Server Note

3️⃣ Additional Information (if required)

Request

Responses

Create Paypal Payment

⚠️ Important Payment Instructions#

1️⃣ Match the Currency#

💱 Supported Currencies#

2️⃣ Include the Server Note#

3️⃣ Additional Information (if required)#

Request

Responses

⚠️ Important Payment Instructions

1️⃣ Match the Currency

💱 Supported Currencies

2️⃣ Include the Server Note

3️⃣ Additional Information (if required)