docs: update README for clarity and accuracy; remove Portuguese link,…

… adjust payment ID retrieval, and clarify validation rules

update readme

ref:update method structure

feat: update to new api

Merge remote-tracking branch 'origin/main'