Now that you know how to publish an item on Wallapop for sale, it’s time to dive into the "Transaction Flow." This journey begins the moment a buyer pays for the item, along with any associated fees, and continues until that eagerly awaited package lands in their hands. Let’s explore the key steps of the transaction flow!
Before we jump into the nitty-gritty of API usage, our aim is to give you a clear overview of the transaction process on Wallapop. For more hands-on implementation guidance, check out the Transactions Guide.
Got items to sell? Here’s the streamlined flow to publish them using the API:
The action kicks off the moment a buyer hits that "Pay" button, settling the cost of the item along with service and delivery fees. This triggers the creation of a shipping request. Wallapop then processes a "pre-authorization" charge to ensure everything is in order.
Next up, the shipping request slides into the seller’s inbox, but it starts off in a pending state. How does the seller find out? They can be notified via a webhook or query the API for a list of pending requests waiting for acceptance by sending a GET /transactions/requests/pending request:
- Production
https://connect.wallapop.com/transactions/requests/pending
- cURL
- Python
- JS
- Go
- Java
- C#
curl -i -X GET \
https://connect.wallapop.com/transactions/requests/pending \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Once the seller approves the shipping request, the shipment process can begin—either through a home pickup or a post office drop-off—by sending one of the following API requests, respectively:
- POST
/transactions/requests/{requestId}/accept/home-pickup - POST
/transactions/requests/{requestId}/accept/post-office
Sellers looking for hassle-free service can enjoy home pickups, with options from trusted carriers like Correos, Seur, GLS, and Method (perfect for those larger items!).
With the seller's acceptance, a shipping transaction springs to life, initially marked as pending. This transaction follows the shipment's lifecycle from acceptance to delivery. Wallapop securely handles the buyer’s payment, temporarily moving funds into an escrow account. Sellers receive a friendly reminder that they have 5 days to get that package on its way, tailored to the delivery method the buyer chose—like dropping it off at Correos.
It’s showtime for the shipment! Whether the seller opts for a post office drop-off, a PUDO location, or home pickup, the package is now in the hands of the carrier for processing.
Once the package is accepted, it begins its exciting journey through the postal network! However, if any hiccups happen along the way—such as an address issue or a special request from the recipient—the package might take a temporary break until everything gets sorted out.
After the transit adventure, the moment of truth arrives! If the recipient chose post office pickup, the package will land at their local post office, ready to be collected. But watch out—if it’s not picked up in time, there’s a chance it will boomerang back to the sender. For home deliveries, the package embarks on its final route. If the recipient isn’t home or the address has a hiccup, a failed delivery attempt could occur. For both pickup and delivery options, the shipment is marked as “Delivered” once it’s successfully received. But if the package ends up unclaimed or undeliverable, it may expire or be returned to the sender.
And there you have it! The Transaction Flow of Wallapop is an engaging journey from payment to delivery, filled with important steps that ensure a smooth experience for both buyers and sellers.
Now that you have a solid understanding of the publishing process and what happens after a sale, including the delivery of the item, we can now move on to learning how to use the API to programmatically sell items on Wallapop.
First things first, check out the Listing Guide!